Setup: Linux

This guide covers setting up MASV Agent on a Linux host machine. If you prefer to use Docker instead, see the Docker setup guide.

Installation

Debian-based systems (apt)

curl -fsSL https://dl.massive.io/agent/publickey.asc | sudo gpg --dearmor -o /etc/apt/keyrings/masv-agent.gpg

echo "deb [arch="$(dpkg --print-architecture)" signed-by=/etc/apt/keyrings/masv-agent.gpg] https://dl.massive.io/agent/deb stable main" | sudo tee /etc/apt/sources.list.d/masv-agent.list > /dev/null

sudo apt update
sudo apt install masv-agent

RPM-based systems (yum)

sudo tee -a /etc/yum.repos.d/masv-agent.repo > /dev/null <<EOF
[masv-agent]
name=MASV Agent
baseurl=https://dl.massive.io/agent/rpm
enabled=1
gpgcheck=1
gpgkey=https://dl.massive.io/agent/publickey.gpg
EOF

sudo yum install masv-agent

RPM-based systems (dnf)

sudo tee -a /etc/yum.repos.d/masv-agent.repo > /dev/null <<EOF
[masv-agent]
name=MASV Agent
baseurl=https://dl.massive.io/agent/rpm
enabled=1
gpgcheck=1
gpgkey=https://dl.massive.io/agent/publickey.gpg
EOF

sudo dnf install masv-agent

Running MASV Agent

Package installation adds a systemd service file masv-agent.service to /usr/lib/systemd/system. This service is configured to automatically start the MASV Agent background server on system startup using the command masv server start.

Caution

• The background systemd service runs as the root user. This grants the background service access to all connected disk drives.
• By default, all downloaded files belong to the root user. To assign file ownership to a particular user, configure the gid/uid parameters when manually starting downloads or when registering Storage Gateway connections.

Manage the service with standard systemctl commands:

# Stop the running service
systemctl stop masv-agent

# Start the service
systemctl start masv-agent

# Restart the service
systemctl restart masv-agent

Parameters

When launching MASV Agent with masv server start, you can configure it using various command-line flags. See the full list in the Getting Started guide.

Next steps

• Authentication — Authenticate with API keys or credentials before transferring files.
• Uploads — Send files via Team email, shareable Link, or Portal.
• Downloads — Initiate, monitor, and manage file downloads.
• Storage Gateway — Connect cloud storage providers to MASV.