Baseguard

macOS Installation

Install Baseguard on macOS

This guide covers installing Baseguard on macOS with Apple Silicon processors.

Download

Download the latest macOS installer:

Download for Apple Silicon

Installation

  1. Open the installer: Double-click the downloaded .pkg file
  2. Follow the prompts: Click through the installation wizard
  3. Authenticate: Enter your administrator password when prompted
  4. 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

PathDescription
/Applications/Baseguard.appApplication
/var/lib/baseguard/Data directory (keys, config)
/var/log/baseguard/Log files
/var/run/baseguard/Runtime files (sockets)
/Library/LaunchDaemons/net.baseguard.daemon.plistLaunch daemon

Using the GUI

After installation, you can use Baseguard from the menu bar:

  1. Click the Baseguard icon in the menu bar
  2. Click Login to authenticate
  3. Click Connect to join the network
  4. 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 status

Verify Installation

baseguard status

Uninstallation

# 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/baseguard

Troubleshooting

See Troubleshooting — Installation & Daemon Issues for solutions.

Next Steps

After installation:

  1. Connect to the network (automatically prompts for login)
  2. Check your status

On this page