Install on Ubuntu VPS

Recommended path for Hetzner, DigitalOcean, Linode, and similar VPSs.

Prerequisites

Use a Linux host with systemd, curl, tar, and a readable SQLite database file. The installer creates a locked-down borela user and stores state under /var/lib/borela.

Install

Replace the API key and database path with values from your dashboard.

curl -fsSL https://borela.dev/install.sh | bash -s -- --api-key brl_xxx --db-path /home/deploy/app/data/app.db --name app

Verify

Confirm the service is running and the dashboard has received a heartbeat.

systemctl status borela-agent
journalctl -u borela-agent -f

Upgrade the agent

When a newer public agent release is available, your dashboard lists the affected projects and shows this command. Run it once on each affected server; one upgrade covers all projects on that server. If already running as root, use bash instead of sudo bash.

The installer preserves your existing configuration and restarts the agent when the binary changes. Refresh the dashboard after its next heartbeat reports the new version to clear the notice. Upgrades are manual; no automatic updater is enabled.

curl -fsSL https://borela.dev/install.sh | sudo bash