Skip to main content

Installation

Prerequisites​

Before installing SiFi Bridge, ensure you have:

  • Hardware: A SiFi Labs device
  • Operating System: Linux (Ubuntu 22.04+, x86 or arm64), macOS (Intel or Apple Silicon), or Windows (x86)
  • Bluetooth Low Energy (BLE) 5.0+

Installation​

Install script​

The easiest way of installing sifibridge is to use the installation script from the repository.

Open PowerShell and run:

irm https://raw.githubusercontent.com/SiFiLabs/sifi-bridge-pub/main/scripts/install.ps1 | iex
warning

The script does not add sifibridge to PATH. To do so, follow the instructions in the terminal. You may have to restart the terminal for changes to take effect.

Manual install​

It is also possible to manually install sifibridge.

  1. Download the latest release from the Releases page
  2. Extract the .zip archive to a convenient location
  3. Move the binary where most appropriate, such as %LOCALAPPDATA%\Programs\SiFiBridge or C:\Program Files\SiFiBridge
  4. Add the directory to your PATH if needed

Verify Installation​

Once installed, verify that SiFi Bridge is working:

$ sifibridge --version
sifibridge 2.0.0

You should see the version number displayed.

Uninstall​

Simply delete the executable file.

Troubleshooting​

"Command not found" error​

Problem: sifibridge: command not found

Solution: The executable isn't in your system PATH.

# Add current directory to PATH temporarily
export PATH=$PATH:.

# Or move the executable to a PATH location
sudo mv ./sifibridge /usr/local/bin/sifibridge

Permission denied on Linux/macOS​

Problem: Permission denied when running the executable

Solution: Make the file executable:

chmod +x sifibridge

macOS security warning​

Problem: "sifibridge cannot be opened because the developer cannot be verified"

Solution: Allow the app in System Preferences:

  1. Go to System Preferences → Security & Privacy
  2. Click "Open Anyway" next to the sifibridge warning
  3. Or use: xattr -d com.apple.quarantine sifibridge

Bluetooth not working​

Problem: Cannot detect devices via Bluetooth

Solution:

  • Ensure Bluetooth is enabled on your system
  • Check that your Bluetooth adapter is recognized
  • Run sifibridge scan to test device discovery