Docs / Upgrade

Upgrading

Upgrades are in-place: install the new version over your existing installation. Your data directory is never touched — projects, users, runs and settings are preserved. The latest release is v1.0.4.

Before you upgrade

  1. Create a backup (see Backup & Restore)
  2. Note your current version (shown on the dashboard / /api/health)
  3. If you are on a supported subscription, your license stays valid — upgrades never invalidate it

Steps

  1. Download the new installer from the Downloads page
  2. Run it over your existing install — the installer stops the service, replaces files, and restarts it
  3. Database migrations apply automatically on first boot (this can take a few minutes)
  4. Verify with /api/health and the dashboard version
  5. Runner agents are version-gated — after a minor or major upgrade, re-download agents from your server

Rollback & troubleshooting

If an upgrade fails, the service keeps restarting with the previous data intact. Re-run the previous installer to roll back, restore the backup if needed, and contact support with the diagnostics from the dashboard.