Skip to content

Reworked "upgrades" section of the Managed Postgres docs for Beta #6283

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
achudnovskij merged 3 commits into from
May 27, 2026
+16 −6
Merged

Reworked "upgrades" section of the Managed Postgres docs for Beta #6283

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
e007fe0
Reworked "upgrades" section of the Managed Postgres docs for Beta
achudnovskij May 26, 2026
6c35125
Apply suggestions from code review
achudnovskij May 27, 2026
6f3de52
Update upgrades.md
achudnovskij May 27, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
22 changes: 16 additions & 6 deletions docs/cloud/managed-postgres/upgrades.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -13,16 +13,26 @@ import BetaBadge from '@theme/badges/BetaBadge';

Managed Postgres handles PostgreSQL version upgrades to keep your instances secure and up to date. Both minor and major version upgrades are supported with minimal disruption.

## Minor version upgrades {#minor-version-upgrades}
## Maintenance updates {#maintenance-updates}

Minor version upgrades (e.g., 16.4 to 16.5) include bug fixes and security patches. These are performed via failover and typically result in only a brief disconnect, often lasting just a few seconds.
Regular maintenance in the PostgreSQL instances includes the following:

For instances with [standbys](/cloud/managed-postgres/high-availability) enabled, the upgrade is applied to the standby first, followed by a failover to minimize downtime.
- Minor version upgrades (e.g., 17.4 to 17.5) include bug fixes and PostgreSQL engine security patches.
- Managed Service features. Improvements to native CDC, observability, pg_clickhouse, and other extensions.
Copy link
Copy Markdown
Collaborator

@dhtclk dhtclk May 26, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- Managed Service features. Improvements to native CDC, observability, pg_clickhouse, and other extensions.
- Managed Service improvements, including native CDC, observability, pg_clickhouse, and other extensions.

- Operating system and system components patches. Including security fixes, efficiency, and other improvements.
Copy link
Copy Markdown
Collaborator

@dhtclk dhtclk May 26, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- Operating system and system components patches. Including security fixes, efficiency, and other improvements.
- Operating system and system component patches, including security fixes, efficiency improvements, and other enhancements.


## Major version upgrades {#major-version-upgrades}
These are performed via failover and typically result in only a brief disconnect, often lasting just a few seconds.

Major version upgrades (e.g., 16.x to 17.x) also involve only a few seconds of downtime, following a similar failover-based approach.
For instances with [standbys](/cloud/managed-postgres/high-availability) enabled, the upgrade is applied to the standby first, followed by a failover to minimize downtime.

## Maintenance windows {#maintenance-windows}

Managed Postgres supports maintenance windows so that upgrades and other maintenance operations can be scheduled at a time that's least disruptive to your workload. UI support for configuring maintenance windows is coming soon. In the meantime, contact [support](https://clickhouse.com/support/program) to set up a maintenance window for your instance.
Default maintenance window is 14:00 to 16:00 UTC on Sunday.
Expected downtime is less than 1 minute within the window.

For Enterprise Tier organizations, Managed Postgres supports maintenance windows so that upgrades and other maintenance operations can be scheduled at a time that's least disruptive to your workload. UI and API support for configuring maintenance windows is coming soon. In the meantime, contact [support](https://clickhouse.com/support/program) to set up a maintenance window for your instance.

## Major version upgrades {#major-version-upgrades}

Major version upgrades (e.g., 17.x to 18.x) via UI and API are coming soon.
In the meantime, contact [support](https://clickhouse.com/support/program) to upgrade your Managed Postgres instance.
Loading