Downloads

One command. Auto-detects your OS and CPU. Works on Linux, Raspberry Pi, and macOS.

Quick install

Run this on any supported machine — Ubuntu, Raspberry Pi OS, or macOS:

curl -fsSL https://qbit.me/install-qbit.sh | bash -s -- -y

One command — and you can read every line of it, including the sandbox runtime that isolates every app and toolset. Browse the open source →

Detects OS
Detects CPU
Installs the qbit agent
Opens setup UI

Safe to re-run — detects an existing qbit agent and never overwrites it. Existing qbit binaries are updated cleanly.

Register IoT devices

Already installed? Connect IoT sensors and devices (MQTT, HTTP REST, or Home Assistant) to your qbit agent. Run this on the same machine where qbit is installed:

curl -fsSL https://qbit.me/install-qbit.sh -o install-qbit.sh && bash install-qbit.sh

Then select 1) Finish setup → 3) IoT from the menu. The wizard walks you through choosing a protocol, configuring the adapter, discovering devices, and registering them. Must be run on the qbit Pi itself.

Uninstall

Removes everything the installer added — binaries, the setup UI bundle, systemd services, and BYOH user data. Your qbit agent (Hermes) is left untouched.

curl -fsSL https://qbit.me/uninstall-qbit.sh | bash -s -- -y

Cloud-side records (device registration, sessions) are not removed — use the qbit Cloud dashboard to decommission the device for full cloud cleanup.

System requirements

Linux (x86_64 & aarch64)

Ubuntu 22.04+, Debian 12+, Raspberry Pi OS (64-bit). Works on standard PCs, servers, and Raspberry Pi 4/5. Requires curl, sudo, and internet access.

macOS

Intel and Apple Silicon. The installer will detect macOS and install the qbit agent, but the qbit browser setup flow is not yet supported on macOS (requires launchd adaptation).

Advanced flags

For users who want more control over the install.

Flag What it does
--skip-hermes Skip Hermes install even if not found
--dry-run Preview all actions without changing the system
--source Build binaries from local repo checkout
--with-ble Also install the optional BLE onboarding service

Browse all artifacts directly