Linux Installation

This guide covers installing Baseguard on Linux distributions including Ubuntu, Debian, CentOS, Fedora, and Arch Linux.

Quick Install

Install Baseguard using the official install script:

curl -fsSL https://install.baseguard.net/linux-install.sh | sudo sh

To include the desktop GUI (system tray app):

curl -fsSL https://install.baseguard.net/linux-install.sh | sudo sh -s -- --gui

Connect to your network:

baseguard connect

The install script will:

• Detect your distribution and architecture
• Download the appropriate binary
• Install Baseguard and its dependencies
• Configure the systemd service
• Start the Baseguard daemon
• With --gui: install the desktop app, system tray icon, and GUI dependencies

GUI Application

The --gui flag installs a desktop application that runs in your system tray, providing a graphical interface for managing connections and viewing network status.

Supported desktop environments:

• GNOME (requires the AppIndicator extension)
• KDE Plasma

File Locations

Verify Installation

Check that the daemon is running:

sudo systemctl status baseguard

Verify the CLI works:

baseguard version

Firewall Configuration

If you have a firewall enabled, allow the following:

• UDP 42273 — Baseguard peer-to-peer traffic
• TCP 443 outbound — Control plane communication

# UFW
sudo ufw allow 42273/udp

# firewalld
sudo firewall-cmd --add-port=42273/udp --permanent
sudo firewall-cmd --reload

Uninstallation

To remove Baseguard (including the GUI if installed):

curl -fsSL https://install.baseguard.net/linux-uninstall.sh | sudo sh

Troubleshooting

See Troubleshooting — Installation & Daemon Issues for solutions to daemon and TUN device problems.

Next Steps

After installation:

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