masvio/masv-agent

By masvio

Updated about 1 month ago

MASV Agent

Image
Networking
Developer tools
Monitoring & observability
0

10K+

masvio/masv-agent repository overview

alt text

MASV is a secure and reliable large file transfer solution, offering unparalleled speed and flexibility for teams who send and receive massive files. MASV leverages AWS to achieve the fastest transfer speeds possible. MASV’s configurable automation and comprehensive workflows simplify file transfer to your cloud or local storage. MASV has completed rigorous third-party evaluations to ensure compliance with the Trusted Partner Network (TPN), ISO 27001, SOC 2, GDPR and PIPEDA.

Try MASV for free https://massive.io/

About MASV Agent

Image provided by massive.io⁠ MASV Agent⁠ (formerly MASV Transfer Agent) is a cross-platform service that manages file transfers⁠. Interaction with the service is performed via REST API calls. It supports uploading and downloading multiple packages simultaneously, while abstracting away filesystem interactions. The MASV Agent is the beating heart of the MASV Desktop App , a trusted local application available for Windows, Mac, and Linux.

Supported Architectures

The MASV Agent supports multiple architectures to allow for deployment in different unique environments. Using the masvio/masv-agent:latest image will automatically pull the correct architecture for your system. The architectures supported by this image are:

ArchitectureTag
x86-64latest
arm64latest

Version Tags

We support a number of different tags for our users and internal development. We recommend using the latest tag for the latest updates and security patches. Other non-version stubbed tags can be unstable and may result in lost data.

TagDescription
latestLatest TransferAgent release
x.y.zSpecific tagged version

MASV Agent Setup

Provisioning the Docker image is very simple. We provide an initial provisioning script to manage automations and authentication for the MASV Agent. You can also customize your setup by using the MASV Agent CLI. By default you can access the MASV Agent at:

http://DOMAIN:8080/

Usage

For ease of use, we have outlined a docker-compose file and Docker CLI command. Both can be used to set up the MASV Agent, however we recommend using Docker Compose.

version: "3"
services:
  transferagent:
    image: masvio/transfer-agent:latest
    container_name: transfer-agent
    environment:
    - PUID=1000
    - PGID=1000
    volumes:
      - /path/to/your/config/:/config
      - /path/to/your/data/:/data
    ports:
      - 8080:8080
    restart: unless-stopped
Docker CLI (More Info)
# Other flags can be defined as outlined in the Parameters section
docker run -p 8080:8080 \
  -v /path/to/your/config:/config \
  -v /path/to/your/data:/data \
  masvio/transfer-agent:latest

Parameters

We can configure the TransferAgent on launch using various command-line flags. The flag name and its description are below.

FlagsTypeDescription
listenStringListen address (port will be system assigned if not specified or 0) (default "http://localhost:8080")
log-formatStringEasy Logrus log format (default "[%lvl%] %time%: %msg%\n")
log-levelStringLog level (debug, info, warning, error) (default "debug")
log-outStringWhere the logs are written (stdout, stderr, {filename}) (default "stdout")
log-timestamp-formatStringEasy Logrus timestamp format (default "15:04:05")
secret-keyStringSecret Key that the server will require as a header, for local security purposes
versionnullShows the current version/build number, as well as any available updates
Volumes

Our TransferAgent expects and creates a few folder on creation of the docker image. These folders can be overridden if required but we recommend keeping the defaults.

VolumeUsage
/configStore application configuration and saved application data
/dataDefault folder to mount in your automated downloads and uploads

Config Files

The /config directory is used to store state files which are intended to persist between restarts

FileUsage
data.dbDatabase file for maintaining application state
settings.ymlConfig file for user settings

Licenses

All dependency licenses are included in the LICENSES.txt file bundled in the release zip files. This LICENSES.txt file is also available at https://dl.massive.io/agent/LICENSES.txt

Tag summary

Content type

Image

Digest

sha256:fda76b043

Size

87.7 MB

Last updated

about 1 month ago

docker pull masvio/masv-agent:3.2.7