2019-03-15 17:41:28 +00:00
|
|
|
---
|
|
|
|
|
tags: dontlink
|
|
|
|
|
sitemap: true
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
# Installing using the macOS installer
|
|
|
|
|
|
2021-06-21 10:14:15 +00:00
|
|
|
Yggdrasil is supported on macOS. Download the macOS `.pkg` file from [GitHub Releases](https://github.com/yggdrasil-network/yggdrasil-go/releases).
|
2019-03-15 17:41:28 +00:00
|
|
|
|
2019-03-15 17:44:04 +00:00
|
|
|
## Install using Finder
|
2019-03-15 17:41:28 +00:00
|
|
|
|
|
|
|
|
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.
|
|
|
|
|
|
2019-03-15 17:44:04 +00:00
|
|
|
## Install using Terminal
|
2019-03-15 17:41:28 +00:00
|
|
|
|
|
|
|
|
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.
|
2022-04-02 13:03:58 +00:00
|
|
|
|
|
|
|
|
## 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
|
|
|
|
|
```
|
