System Bridge

Running

Windows

After installation, System Bridge can be started from the Start Menu shortcut that gets created during installation. Look for “System Bridge” in your Start Menu.

ℹ️

The Start Menu shortcut may not appear immediately after installation until Windows indexes it. If you cannot find it, try searching for “System Bridge” in the Start Menu or restart Windows Explorer.

Alternatively, you can start System Bridge from a terminal:

cd "C:\Program Files\System Bridge"
.\system-bridge.exe backend
ℹ️

Simply double-clicking system-bridge.exe will not start the application visibly. You must use the backend command or the Start Menu shortcut.

You can enable autostart in the settings. This may require restarting the application to apply.

Linux (Terminal)

You can launch the app via the terminal:

system-bridge backend

Linux (Systemd)

⚠️

Not supported with AppImage or Flatpak. You will need to configure the service manually to the correct path.

  1. Create a systemd service file at /etc/systemd/system/system-bridge.service:
[Unit]
Description=System Bridge
After=network.target

[Service]
Type=simple
ExecStart=/usr/bin/system-bridge backend
Restart=on-failure
RestartSec=5
StandardOutput=journal
StandardError=journal
SyslogIdentifier=system-bridge
Environment="HOME=/root"

[Install]
WantedBy=multi-user.target
ℹ️

The Environment="HOME=/root" setting is required for System Bridge to locate its configuration directory. Without this, the service will fail to start with a configuration path error.

  1. Reload systemd daemon:
sudo systemctl daemon-reload
  1. Enable the service to start on boot:
sudo systemctl enable system-bridge
  1. Start the service:
sudo systemctl start system-bridge
  1. Check the service status:
sudo systemctl status system-bridge

Token

The token is essential to connect to the API/WebSocket. You can get it using the CLI command:

system-bridge client token

Alternatively, you can find your Token in the application startup logs when running the backend. The logs will show “Your API token is” followed by your token value.