Installing using the macOS installer

Yggdrasil is supported on macOS. Download the macOS .pkg file from GitHub Releases.

Install using Finder

Locate the downloaded .pkg installer in Finder. Right-click it and click Open.

Step through the installer as usual.

Once completed, the Yggdrasil configuration will have automatically been generated, the launchd service will have been installed and the service will be running.

Install using Terminal

Open Terminal.app and install the package:

sudo installer -pkg /path/to/yggdrasil-xxx-macos.pkg -target /

Once completed, the Yggdrasil configuration will have automatically been generated, the launchd service will have been installed and the service will be running.

Managing the Yggdrasil service

Yggdrasil runs under launchd so it will run automatically at startup and will restart if the process is killed.

To stop the service or prevent it from starting automatically, use launchctl to unload the service:

sudo launchctl unload /Library/LaunchDaemons/yggdrasil.plist

To start it again, load the service:

sudo launchctl load /Library/LaunchDaemons/yggdrasil.plist