Skip to content

Explain that auto-upgrade follows every published stack revision - #136

Merged
csandanov merged 1 commit into
masterfrom
docs/stack-auto-upgrade-triggers
Sep 30, 2026
Merged

csandanov merged 1 commit into
masterfrom
docs/stack-auto-upgrade-triggers

Conversation

@csandanov

Copy link
Copy Markdown
Member

The stack docs said that only automatic stack updates auto-upgrade app environments. They also said that manual stack updates, manual syncs and published drafts never move app environments forward. That's not how auto-upgrade works. An app environment with auto-upgrade enabled moves to the stack's latest published revision during its upgrade time window, however that revision was published. Automatic stack updates only start it sooner.

This updates the three pages that describe it:

  • Application stack → Auto-upgrade:
    • Auto-upgrade follows every published revision. Automatic stack updates start it right away, and Wodby also regularly checks for environments with auto-upgrade enabled that still run an older revision.
    • To control a rollout yourself, disable auto-upgrade for those environments or keep the change in a draft. Unpublished drafts are never applied.
  • Stacks overview and Stack updates: publishing a revision moves app environments with auto-upgrade enabled during their upgrade time window. Other environments keep their revision until they are upgraded.

This matches current product behavior and can be merged now.

Validation

  • Links point to the existing apps/stack.md#auto-upgrade anchor, which other pages already use.

The stack pages said that only automatic stack updates auto-upgrade app environments, and that manual updates, manual syncs and published drafts never do. App environments with auto-upgrade enabled move to the latest published revision during their upgrade time window, however it was published. Describe that, and how to keep control of a rollout: disable auto-upgrade for those environments or keep the change in a draft.
@csandanov
csandanov merged commit 428e9af into master Sep 30, 2026
1 check passed
@csandanov
csandanov deleted the docs/stack-auto-upgrade-triggers branch October 15, 2026 10:54
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant