docs/content/product/administration/workspace/maintenance-window.mdx
Cube Cloud can apply platform updates to your infrastructure during a scheduled weekly time slot instead of immediately as they are released. This gives you control over when updates happen, reducing the risk of unexpected changes during peak hours.
<InfoBox>Maintenance window is available for deployments with dedicated infrastructure on Enterprise and above plans.
</InfoBox>Cube Cloud automatically takes daily snapshots of all current service versions. Each snapshot captures a consistent, known-good combination of service versions at that point in time.
A snapshot must be at least 24 hours old before it becomes eligible for deployment. This ensures that only versions confirmed stable in production are promoted to tenants with a maintenance window enabled.
During the configured maintenance window, the system automatically advances your deployment to the latest eligible snapshot. Outside of the window, no updates are applied.
<InfoBox>You do not choose specific versions. The system manages version progression automatically — the maintenance window only controls when the update happens.
</InfoBox>The maintenance window applies to all Cube Cloud services for your deployment, including:
Both control-plane and data-plane services are updated to the same snapshot during the window.
Navigate to <Btn>Admin → Settings → Maintenance Window</Btn> in the Cube Cloud console.
<Screenshot src="https://lgo0ecceic.ucarecd.net/e6db33a7-0d5e-4e28-8494-554393eaf2cb/" />Settings are saved automatically.
<WarningBox>The maintenance window spans one hour starting from the selected time. For example, selecting 02:00 means updates may be applied between 02:00 and 02:59 UTC on the selected day.
</WarningBox>When you enable the maintenance window for the first time, the day defaults to Sunday and the time defaults to 02:00 UTC. Your deployment is immediately assigned the latest eligible snapshot so that it starts from a known, stable version.
When the maintenance window is enabled and your deployment has been updated at least once, an Active Version section appears below the schedule settings.
The Active Version dropdown shows all snapshots that were active
for your deployment within the last 7 days. The currently active
snapshot is pre-selected and marked with (current).
To switch to a different version, select it from the dropdown. The change takes effect on the next reconciliation cycle.
<WarningBox>Only snapshots from the last 7 days are available. If you need to revert to an older version, contact support.
</WarningBox>If a critical fix has been released and you don't want to wait for the next scheduled maintenance window, you can upgrade to the current production versions immediately.
When the maintenance window is enabled, an Upgrade Now section appears at the bottom of the settings page. Click Upgrade Now to create a snapshot from the service versions currently running in production and switch your deployment to it right away.
The button is disabled while the upgrade is in progress. Once complete, the new version will appear in the Active Version dropdown.
<InfoBox>Unlike the scheduled maintenance window, Upgrade Now does not require a 24-hour eligibility buffer — it always uses the versions running in production at the time you click the button. If your deployment is already running those versions, the button will return an error.
</InfoBox>Your deployment returns to the default behavior — receiving updates immediately as they are released.
Nothing happens. The system only advances your deployment if a newer eligible snapshot exists. If you are already on the latest eligible snapshot, the maintenance window is a no-op.
At most, your services will be behind by the interval between your maintenance windows (typically one week) plus the 24-hour eligibility buffer. For example, with a Sunday 02:00 UTC window, your services could be up to ~8 days behind the latest release in the worst case.
Yes. When the maintenance window is enabled, the settings page shows an Active Version dropdown listing all snapshots from the last 7 days. Select any of them to switch back. See Active version above for details.
Yes. Use the Upgrade Now button on the settings page to upgrade to the current production versions immediately, without waiting for the 24-hour eligibility buffer. See Upgrade now above for details.