Adding a Device

To connect a device to the SSH Bridge VPN network, generate an auth key and install the SSH Bridge Network Client on that device.

Step 1: Generate an Auth Key

1. Go to Machines in the sidebar
2. Click Add Device in the header
3. Enter a name for your device (e.g., my-laptop)
4. Click Generate Auth Key
5. Copy the command shown in the dialog

The auth key expires in 24 hours and can only be used once.

Device Naming Rules

• Lowercase letters, numbers, and hyphens only
• Cannot start or end with a hyphen
• Maximum 63 characters

Examples: my-laptop, office-pc, dev-server-01

Step 2: Install SSH Bridge Network Client

Install the SSH Bridge Network Client on the device you want to connect.

Desktop devices

For macOS, Windows, and Linux desktops, download the SSH Bridge Network Client from the Download page. Install the app for your platform, then use the auth key from SSH Bridge to add the device.

Linux servers or headless devices

If the Linux device does not have a desktop environment, run the installer with your generated auth key:

curl -fsSL https://twz-websites-sb.themewizz.com/storage/v1/object/public/sshbridge-apps/network/install.sh | sh -s -- --authkey <Key>

Replace <Key> with the auth key generated in the Add Device dialog.

Step 3: Start the Daemon

On Linux, make sure the SSH Bridge daemon is enabled and running:

sudo systemctl enable --now sshbridge-daemon

To check the daemon status:

systemctl status sshbridge-daemon

Platform-specific notes:

• macOS, Windows, and Linux desktops — Use the installer from the Download page and follow the SSH Bridge Network Client prompts.
• Linux servers or headless devices — Use the installer command with --authkey <Key>, then verify sshbridge-daemon is running.

Step 4: Verify

After installation, your device should appear in the Machines panel in SSH Bridge. On Linux, you can verify that the daemon is running:

systemctl status sshbridge-daemon

The Machines panel shows connected devices with their VPN IPs and connection status.