macOS Installation
Install Baseguard on macOS
This guide covers installing Baseguard on macOS with Apple Silicon processors.
Download
Download the latest macOS installer:
Installation
- Open the installer: Double-click the downloaded
.pkgfile - Follow the prompts: Click through the installation wizard
- Authenticate: Enter your administrator password when prompted
- Complete: The installer will configure everything automatically
The installer will:
- Install the Baseguard application to
/Applications/Baseguard.app - Configure a LaunchDaemon for automatic startup
File Locations
| Path | Description |
|---|---|
/Applications/Baseguard.app | Application |
/var/lib/baseguard/ | Data directory (keys, config) |
/var/log/baseguard/ | Log files |
/var/run/baseguard/ | Runtime files (sockets) |
/Library/LaunchDaemons/net.baseguard.daemon.plist | Launch daemon |
Using the GUI
After installation, you can use Baseguard from the menu bar:
- Click the Baseguard icon in the menu bar
- Click Login to authenticate
- Click Connect to join the network
- View connected nodes and network status
Using the CLI
The CLI is available for advanced users and automation:
# Check version
baseguard version
# Connect (automatically prompts for login if needed)
baseguard connect
# View status
baseguard statusVerify Installation
baseguard statusUninstallation
# Remove daemon
sudo launchctl bootout system/net.baseguard.daemon 2>/dev/null || true
sudo rm -f /Library/LaunchDaemons/net.baseguard.daemon.plist
# Remove application
sudo rm -rf /Applications/Baseguard.app
# Remove CLI symlink
sudo rm /usr/local/bin/baseguardTroubleshooting
See Troubleshooting — Installation & Daemon Issues for solutions.
Next Steps
After installation:
- Connect to the network (automatically prompts for login)
- Check your status