Skip to main content

1. Install the server

The server runs on your desktop (Root Node) and is managed through hirocli. Install uv, then install hirocli:
uv tool install hirocli
Initialize a workspace and start the server:
hirocli setup --workspace home
See Setup and uninstall for all setup options.

2. Install the gateway

The gateway handles authentication and routes traffic between your devices and the server. Install uv, then install hirogateway:
uv tool install hirogateway
Create and start a gateway instance:
hirogateway instance create home --host 0.0.0.0 --port 8765 --desktop-pubkey "<base64-public-key>" --set-default
hirogateway start
See Gateway CLI commands for the full setup flow.

3. Install the mobile or web app

Install Flutter, then build and run the app:
flutter run
Once the app is running, pair your device through the app to connect it to your workspace.