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 the following 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.