Updates & licensing

Updating

An admin banner appears in Orbit whenever a new version has shipped. To update, go to Settings → Updates:

• Check now — manually re-checks for a new version instead of waiting for the periodic check.
• Update now — pulls the new images, health-checks them, and restarts the affected services. Progress is polled automatically every few seconds until it finishes.
• Rollback — if an update fails (or you just want to go back), one click restores the previous version the same way.

There’s no docker compose pull to run by hand — the Updater service (a separate container running alongside the app) does the pull/restart/health-check cycle for you, using a short-lived registry token it fetches fresh from Kuzium’s License Server for every single update.

Interrupted updates recover on their own

If the update service itself gets restarted mid-update (a crash, a host reboot, an OOM kill), it can’t still genuinely be “in progress” — whatever was doing the actual work died with the process. The Updater detects this on its own startup and marks the interrupted operation as failed (with an explanation) instead of leaving it stuck, so you’re never left needing to SSH in and edit state files by hand to unblock a future update attempt.

Licensing

Your license file (license.lic) caps your seat count and expiry. It’s checked in periodically over the internet — the only thing that ever “calls home” — and re-read on every check, so a renewed or updated license takes effect within seconds, no restart needed. You can confirm the current status from a logged-in admin session via GET /api/v1/auth/license-status.

An expired or unreachable license never breaks the running app or locks you out of your data. It only pauses two things until it’s resolved:

• Adding new seats
• Pulling updates (the registry token above comes from the same license check)

To renew or change tiers, go back to your Kuzium account at orbit.kuzium.com/self-hosted. Need more seats than your current tier allows? Reach out from your account and request an increase — you don’t need to move to Enterprise just to grow; Enterprise is for unlimited seats and custom terms.

Next: Backups & add-ons.