Skip to content

Native setup

This is the guide for setting up MASV Agent on a Linux host machine. If you're interested in setting things up with Docker, see our Docker Setup Guide

Installation

Debian-based systems

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

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 update
sudo yum install masv-agent

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 update
sudo dnf install masv-agent

Running MASV Agent

By default, package installation will add a systemd service file masv-agent.service. This file is added to /usr/lib/systemd/system.

This service is configured to automatically run the masv agent background server on system startup, using the command masv server start.

This system service can be managed with systemd commands 

# stops the already running service
systemctl stop masv-agent

# starts a service
systemctl start masv-agent

# stops and starts a service
systemctl restart masv-agent

Parameters

When launching the MASV agent with masv server start, you can configure it using various command-line flags. See the full list here

Next steps

  • Downloads: Start, monitor, and manage downloads with the MASV Agent.
  • Uploads: Start, monitor, and manage uploads with the MASV Agent.
  • Storage Gateway: Set up secure remote access to storage devices.