Skip to content

Native setup

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

Installation

MacOS agent installation is offered via homebrew.

brew tap masv/masv https://gitlab.com/masvio/opensource/homebrew-masv.git
brew install masv-agent

Running MASV Agent

By default, package installation will add a launchd service file io.masv.agent.plist. This file is added to ~/Library/LaunchAgents.

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
launchctl stop io.masv.agent

# starts a stopped service
launchctl start io.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.