Upgrade

This page covers upgrading an existing Manifest Self-Hosted 2.x installation to a newer release.

🚧

Upgrading from v1?

Installations from the v1 installer generation cannot be upgraded in place to 2.x. See Self-Hosted v1 (Legacy) for the v1 upgrade documentation and the migration path to 2.x.

📘

Versions

Released versions are published on the manifest-self-hosted Releases page. Manifest Cyber will tell you which version to install.

1. Take an instance snapshot

Take an instance snapshot of the host. manifest-installer does not back up the cluster for you — recovery from a failed upgrade is the snapshot you take here (VM snapshot, EBS snapshot, hypervisor snapshot, whatever your platform provides).

2. Run the upgrade

manifest-installer download --version <new-version>
manifest-installer deploy --version <new-version>

When the requested version is newer than what's installed, deploy confirms interactively — the prompt names the snapshot precondition explicitly — and then applies the new version and updates the recorded installation version on success. Pass --yes to skip the confirmation for unattended runs (only do this when the snapshot from step 1 is taken by a wrapper around deploy).

Upgrades typically take 10–20 minutes depending on image-pull speed and host performance.

Re-running setup is only needed if the new version's config schema has changed. Release notes will call this out explicitly when applicable.

3. Verify the upgrade

📘

status command

The manifest-installer status health-report command is not yet available in this release. Until it ships, verify the upgrade with kubectl as below.

Confirm the cluster is healthy:

kubectl get nodes
kubectl get pods -A

All pods should reach Running or Completed.

If the upgrade fails

Restore the host from the instance snapshot you took in step 1, then contact support if needed. There is no manifest-installer rollback command.

Downgrades are refused. Running deploy --version with a version older than the cluster's current version exits with an error. Restore from your pre-upgrade snapshot or contact support for an assisted downgrade.

For additional assistance, contact Manifest Cyber support at [email protected].