Download & Install
Download the package for your platform from the releases page.
Each release ships these assets:
- Arch Linux:
system-bridge-<version>-1-x86_64.pkg.tar.zst - Debian / Ubuntu:
system-bridge_<version>_<arch>.deb - Fedora / RHEL:
system-bridge-<version>.<arch>.rpm - Flatpak:
system-bridge-<version>.flatpak - Windows:
system-bridge-<version>-setup.exe
Install the package that matches your distribution’s package manager.
Install from the AUR with an AUR helper such as yay.
For the latest stable release, use the system-bridge package:
yay -S system-bridgeFor the development branch, use the system-bridge-git package. This builds and installs the application from the latest dev branch, which is updated automatically every commit:
yay -S system-bridge-gitAlternatively, install the .pkg.tar.zst from the releases page or downloaded workflow asset directly:
sudo pacman -U system-bridge-<version>-1-x86_64.pkg.tar.zstInstall the .deb asset with apt so dependencies are resolved automatically:
sudo apt install ./system-bridge_<version>_<arch>.debYou can also install it with dpkg:
sudo dpkg -i system-bridge_<version>_<arch>.debInstall the .rpm asset with dnf:
sudo dnf install ./system-bridge-<version>.<arch>.rpmInstall the .flatpak bundle:
flatpak install system-bridge-<version>.flatpakThen run it with:
flatpak run dev.timmo.system-bridgeRun the system-bridge-<version>-setup.exe installer to install the application. After installation completes, you can start System Bridge from the Start Menu shortcut.
macOS is not officially supported and has no prebuilt packages. You can still build it from source and test it for yourself.
See Developing for the full build, run, and test workflow from source.
Next steps
Section titled “Next steps”- Start System Bridge: see Running.
- Monitor and control your system from the web client.
- Explore the CLI and TUI, and get your token.
- Connect it to Home Assistant.