Setup: macOS

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

Installation

macOS agent installation is available via Homebrew:

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

Running MASV Agent

Package installation adds a launchd service file io.masv.agent.plist to ~/Library/LaunchAgents. This service is configured to automatically start the MASV Agent background server on system startup using the command masv server start.

Manage the service with the following commands:

# Stop the running service
launchctl stop io.masv.agent

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