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
- Create a backup (see Backup & Restore)
- Note your current version (shown on the dashboard /
/api/health) - If you are on a supported subscription, your license stays valid — upgrades never invalidate it
Steps
- Download the new installer from the Downloads page
- Run it over your existing install — the installer stops the service, replaces files, and restarts it
- Database migrations apply automatically on first boot (this can take a few minutes)
- Verify with
/api/healthand the dashboard version - 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.