How to upgrade Uncloud to a new version.

Upgrade Process

1. Back Up

Before upgrading, back up your data:

2. Pull Latest Code

3. Rebuild the Backend

4. Rebuild the Frontend

5. Restart the Services

6. Run Migrations

Uncloud auto-creates new tables on startup. If a schema change requires migration, it will be noted in the release notes.

7. Verify

Rollback

If something goes wrong:

Zero-Downtime Upgrades

For production environments:
  1. Build the new binary separately
  2. Stop the old process
  3. Start the new process
  4. The SQLite database handles the transition seamlessly
  5. Kubernetes workloads continue running — the API server restart doesn’t affect running VMs or apps
The sync loop will resume reconciliation after the API server restarts. There may be a brief period (up to 15 seconds) where status updates are delayed.