Upgrades and Maintenance

An upgrade is a re-run of oms install codesphere against a newer installer package and the same config.yaml/vault, following Run the installer.

Expect downtime during the platform upgrade step​

When the installer detects an existing Codesphere installation, it puts the platform into maintenance mode before applying database migrations: platform services other than the IDE service are scaled down for the duration of the migration, then scaled back up once the upgrade completes. Plan a maintenance window for this step — workspaces and hosted applications are not reachable while it runs.

Resuming after a failed or partial run​

Re-running oms install codesphere is safe to attempt after a failure. Use --skip-steps (or operations.skip in config.yaml) to skip steps that already completed successfully, and run a single phase (infra, dependencies, or platform) if you only need to retry part of the installation. See Install steps and profiles for the full step list and skip semantics.

Before you upgrade​

Back up the encrypted vault and the age identity — they are required to recover or update the installation; see Encrypt the secrets and configure DNS.