Installing drasyl on macOS
This guide walks you through installing drasyl on macOS. drasyl consists of two main components:
- drasyl daemon: runs as a background service
- drasyl UI: menu bar application to manage the daemon
Installation Methodsβ
We provide two installation methods:
- macOS Package Installer (.pkg) (Recommended)
- Homebrew
Method 1: macOS Package Installer (Recommended)β
The simplest way to install drasyl is via the provided .pkg
installer, which sets up both the daemon and UI automatically.
Step 1: Download the Installerβ
Choose the appropriate installer for your Mac:
- Apple Silicon
- Intel
Click the following link to download the Apple Silicon installer: π¦ drasyl_0.1.0_macos_arm64.pkg
Click the following link to download the Intel installer: π¦ drasyl_0.1.0_macos_x86_64.pkg
If macOS warns you that the file can't be verified, open System Preferences > Security & Privacy, scroll down, and click "Open Anyway".
Step 2: Run the Installerβ
- Open the
.pkg
file from your Downloads folder or browser. - macOS will ask you to confirm that you want to install the software. Click "Allow".
- Follow the steps in the installation wizard.
- After completion, the daemon starts automatically as a background service.

Figure 1: macOS installer welcome screen
Step 3: Start the drasyl UIβ
- Open Spotlight (
Cmd + Space
), search for "drasyl UI", and launch it. - The UI will appear as an icon in your menu bar (top-right corner).
- If you donβt see it, check the overflow area of the menu bar.
On first startup, the UI may take a few seconds to connect to the daemon while it completes the proof-of-work process to generate your device identity.
Once connected, the drasyl UI displays the public key of your device.

Figure 2: macOS menu bar showing the drasyl UI application
You can copy your public key by clicking on it in the drasyl UI.
Alternatively, run drasyl status
in your terminal to display it.
Method 2: Homebrew Installationβ
If you prefer managing software via Homebrew, you can install drasyl from the terminal.
Step 1: Install the drasyl Daemonβ
brew install drasyl/tap/drasyl
Copy the authentication token:
An API auth token has been created at:
/opt/homebrew/etc/drasyl/auth.token
To use drasyl you must copy it into your home directory:
mkdir -p ~/.drasyl
cp /opt/homebrew/etc/drasyl/auth.token ~/.drasyl/auth.token
chmod 600 ~/.drasyl/auth.token
Start the daemon:
sudo brew services start drasyl/tap/drasyl
This ensures that the drasyl daemon starts automatically with macOS.
Step 2: Install and start the UIβ
brew install drasyl/tap/drasyl-ui
- Open Spotlight (
Cmd + Space
), search for "drasyl UI", and launch it. - The UI will appear as an icon in your menu bar (top-right corner).
- If you donβt see it, check the overflow area of the menu bar.
On first startup, the UI may take a few seconds to connect to the daemon while it completes the proof-of-work process to generate your device identity.
Once connected, the drasyl UI displays the public key of your device.

Figure 2: macOS menu bar showing the drasyl UI application
You can copy your public key by clicking on it in the drasyl UI.
Alternatively, run drasyl status
in your terminal to display it.
Next Stepβ
- β drasyl is now installed.
- π Proceed to set up your first network to start connecting devices.