Install on macOS

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

Installation

macOS MASV Engine installation is available via Homebrew:

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

Running MASV Engine

Package installation adds a launchd service file io.masv.engine.plist to ~/Library/LaunchAgents. This service is configured to automatically start the MASV Engine 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.engine

# Start a stopped service
launchctl start io.masv.engine

Parameters

When launching MASV Engine with masv server start, you can configure it using 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.