Skip to main content
Applies to: existing 4.x installations, both editions and deployment methods. Upgrade one minor at a time, to its latest patch, as described in Upgrade paths. Read the row for the minor you upgrade to. The detailed 4.0 and 4.7 instructions remain separate.

Before

4.9.0’s SSO auto-linking change was adjusted in 4.9.1. Later 4.9 patches also change SSO account-deletion confirmation. Use the latest patch of the line and test the flows you rely on rather than selecting .0. Do not copy a newer chart’s gateway configuration into an older release without checking its supported values.

During

Use the 4.x/5.x maintenance procedure. Startup applies pending schema and data migrations. Keep all writers stopped and traffic closed until migrations and required backfills complete. Install every 4.x minor in turn. Skipping a minor is not supported.

After

Complete the row-specific checks and the shared acceptance checklist. Verify an existing account and an existing integration; testing only newly created data can miss migration failures.

Recovery

These releases include dropped fields, renamed structures and data rewrites. Use a coordinated restore when required; do not assume an image-only downgrade is safe across 4.x minors. All changes: 4.0.0 through 4.9.7. See each published release for the complete product changes.