---
title: "Cluster maintenance window"
url: https://docs.corefinity.com/guides/corecluster/cluster-maintenance-window
type: guide
last_updated: 2026-11-13
feature: maintenance-windows
related:
  - https://docs.corefinity.com/api/reference/site-settings/get-company-maintenance-window.md
  - https://docs.corefinity.com/api/reference/site-settings/update-company-maintenance-window.md
  - https://docs.corefinity.com/api/reference/site-settings/delete-company-maintenance-window.md
  - https://docs.corefinity.com/api/reference/site-settings/preview-company-maintenance-window.md
  - https://docs.corefinity.com/api/reference/site-settings/get-cluster-maintenance-window.md
  - https://docs.corefinity.com/api/reference/site-settings/update-cluster-maintenance-window.md
  - https://docs.corefinity.com/mcp/tools/corestack_maintenance_window_get.md
  - https://docs.corefinity.com/mcp/tools/corestack_maintenance_window_set.md
  - https://docs.corefinity.com/mcp/tools/corestack_maintenance_window_clear.md
  - https://docs.corefinity.com/mcp/tools/corecluster_maintenance_window_get.md
  - https://docs.corefinity.com/mcp/tools/corecluster_maintenance_window_set.md
  - https://docs.corefinity.com/mcp/tools/corecluster_maintenance_window_clear.md
---
# Cluster maintenance window

Choose the window in which routine maintenance happens on a CoreCluster's sites.

## Before you start

- Your organisation has a CoreCluster. Anyone in the organisation can change its window.
- The window applies to every site on the cluster that has no window of its own: see [Maintenance window](/guides/sites/site-settings/maintenance-window).

## Set the cluster's window

1. **Open Maintenance window**

   Go to **Managed Clusters**, choose the cluster, then **Maintenance window**. The card shows the window and where it comes from, such as **Corefinity default**: choose **Edit**.

   _Screenshot: The Default maintenance window card of a CoreCluster: 00:00 to 04:00 UK time, marked Corefinity default, on a 24-hour bar, with the Edit button ringed._

2. **Choose the start**

   Turn off **Use the default**, then choose the hour under **Starts at**.

   _Screenshot: The Default maintenance window dialog with Use the default off and Starts at set to 02:00: the bar shows 02:00 to 06:00 UK time, marked This cluster._

3. **Save**

   Choose **Save**.

The cluster's header and the card show the new window, marked **This cluster**. Sites with a window of their own keep it.

## Go back to the default

1. **Turn the default on**

   Choose **Edit**, turn on **Use the default**, then choose **Save**.

The cluster follows your organisation's window, or Corefinity's when your organisation has none: see [Default maintenance window](/guides/organisation/hosting-defaults/default-maintenance-window).

## Automate this

**API:** [Update a CoreCluster's maintenance window](https://docs.corefinity.com/api/reference/site-settings/update-cluster-maintenance-window.md), scope `write`

```bash
curl -X PUT https://manage.corefinity.com/api/coreclusters/1017/maintenance-window \
  -H "Authorization: Bearer $COREFINITY_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "start_hour": 3
  }'
```

**MCP:** [`corecluster_maintenance_window_set`](https://docs.corefinity.com/mcp/tools/corecluster_maintenance_window_set.md), scope `write`

```json
{
  "name": "corecluster_maintenance_window_set",
  "arguments": {
    "cluster_id": 12,
    "start_hour": 1
  }
}
```

**Control Panel:** Managed Websites › your site › Overview ([https://manage.corefinity.com/go/maintenance-windows](https://manage.corefinity.com/go/maintenance-windows))

## Related

- [Maintenance window](/guides/sites/site-settings/maintenance-window): Choose when routine maintenance happens on a site.
- [Default maintenance window](/guides/organisation/hosting-defaults/default-maintenance-window): Choose when routine maintenance happens.
- [Pending changes and apply windows](/guides/sites/size-and-capacity/pending-changes-and-apply-windows): Choose when a change applies.
