Skip to main content

Upgrades

With ClickHouse Cloud you never have to worry about patching and upgrades. We roll out upgrades that include fixes, new features and performance improvements on a periodic basis. For the full list of what is new with ClickHouse refer to our Cloud changelog.

Version compatibility​

When you create a service, the compatibility setting is set to the most up-to-date ClickHouse version offered on ClickHouse Cloud at the time your service is initially provisioned.

The compatibility setting allows you to use default values of settings from previous versions. When your service is upgraded to a new version, the version specified for the compatibility setting does not change. This means that default values for settings that existed when you first created your service will not change (unless you have already overriden those default values, in which case they will persist after the upgrade).

You cannot manage the compatibility setting for your service. You must contact support if you would like to change the version set for your compatibility setting.

Maintenance mode​

At times, it may be necessary for us to update your service, which could require us to disable certain features such as scaling or idling. In rare cases, we may need to take action on a service that is experiencing issues and bring it back to a healthy state. During such maintenance, you will see a banner on the service page that says "Maintenance in progress". You may still be able to use the service for queries during this time.

You will not be charged for the time that the service is under maintenance. Maintenance mode is a rare occurrence and should not be confused with regular service upgrades.

Release channels (upgrade schedule)​

You are able to specify the upgrade schedule for your ClickHouse Cloud service by subscribing to a specific release channel. Besides the regular upgrade schedule, we offer a Fast release channel if you would like your services to receive updates ahead of the regular release schedule. Subscribing to the Fast release channel for early upgrades is recommended only for non-production environments and can be requested by logging a support ticket.

Fast release channel (early upgrades)​

  • Receive the latest ClickHouse releases

  • More frequent upgrades as new releases are tested

  • Recommended for non-production environments

  • Supported for both the Production and Development services

  • Supported for Production services at this time

    You can modify the release schedule of the service in the Cloud console. The configuration is under the Settings tab of the Service.

    image

    image

Regular release channel​

  • Recommended for production environments
  • New minor versions are released at least two weeks after the Fast release channel
  • New patch versions are released at least two days after the Fast release channel