Quick Start

Get connected to your Baseguard network in three steps.

Prerequisites

• A Baseguard account with access to an organization
• A supported device (Linux, macOS, or Windows)

Step 1: Install

Choose your platform:

Linux

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

This installs Baseguard and starts the daemon automatically. To also install the desktop GUI, add the --gui flag:

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

For more details, see the Linux Installation Guide.

macOS

1. Download for Apple Silicon
2. Open the installer and follow the prompts

For details, see the macOS Installation Guide.

Windows

1. Download for Windows x64
2. Run the installer and follow the prompts

For details, see the Windows Installation Guide.

Step 2: Connect

Run the connect command:

baseguard connect

If this is your first time, you'll see an authorization prompt:

Please authorize your device.

   https://console.baseguard.net/auth/device?code=ABCD-1234

1. Open the URL in your browser
2. Log in with your credentials (if not already logged in)
3. Click Authorize to approve the device

Once authorized, the command completes and you're connected.

Step 3: Verify

Check your connection and see other devices on the network:

baseguard status

Example output:

NODE              OVERLAY IP      STATUS    TYPE    ENDPOINT              RX        TX
----              ----------      ------    ----    --------              --        --
my-laptop (local) 100.64.0.5      -         Idle    -                     0         0
server-01         100.64.0.2      online    P2P     203.0.113.10:42273    1258000   820000
desktop           100.64.0.3      online    Relay   rly_abc123def456ghij  512000    310000

Test connectivity by pinging another device:

ping 100.64.0.2

You're connected!

Next Steps

Troubleshooting

See the Troubleshooting Guide for solutions to common issues including daemon problems, connection timeouts, and authentication issues.

See Also

• Core Concepts — How Baseguard mesh networking works
• Security — Encryption and authentication details
• First Network — Advanced network setup