Getting started

You need Rust 1.91 or newer, Node 20 or newer, and pnpm 10.

Start the gateway

pnpm install
pnpm --dir apps/web build
BACKU_DEV_EMAIL_LINKS=true cargo run -p backu-server

Open http://localhost:3000/dash/, create an account with a passkey, and follow the development verification link.

Connect a machine

From another terminal in the repository:

cargo run -p backu-cli -- daemon \
  --server-endpoint http://localhost:3000 \
  --name "Demo workstation" \
  --root "Demo=$PWD/apps/cli/testdata/demo"

Refresh the web app. The machine and its demo root should appear immediately.

Production email

Set BACKU_PUBLIC_URL to your HTTPS origin, then configure BACKU_RESEND_API_KEY and BACKU_EMAIL_FROM. Leave BACKU_DEV_EMAIL_LINKS unset in production.

The server serves the web app at /dash by default for self-hosted deployments. Set BACKU_SERVE_UI=false when the web app is deployed separately and the Rust process should expose only its API.