> This page location: /docs.md > /docs/management.md > /docs/atlas/create-connect-deployments.md > /docs/atlas/manage-clusters.md > /docs/atlas/tutorial/cluster-maintenance-window.md

> For the complete MongoDB documentation index, see www.mongodb.com/docs/llms.txt

# Begin or Defer Scheduled Maintenance

**Note:**

This page applies to both Atlas Infinite and Atlas Core.

When Atlas schedules required maintenance for your clusters, you can begin the maintenance immediately or defer it for one week. To learn more about how Atlas rolls out maintenance, see [Manage Cluster Maintenance.](https://www.mongodb.com/docs/atlas/tutorial/cluster-maintenance-window.md#std-label-configure-maintenance-window)

When maintenance is required:

- Between 48 and 72 hours (2-3 days) before the scheduled maintenance, Atlas displays a banner in your project's cluster list showing the date and time when the maintenance is scheduled. Click Show Details to see the scheduled maintenance operations, such as MongoDB version updates, OS policy updates, or other maintenance types.

- Atlas sends an email to users with the [`Project Owner`](https://www.mongodb.com/docs/atlas/reference/user-roles.md#mongodb-authrole-Project-Owner) role and updates the Atlas UI to display the option to begin maintenance immediately or to defer maintenance for one week.

  **Note:**

  To configure how you receive scheduled maintenance window notifications, see [Configure a Maintenance Window Alert.](https://www.mongodb.com/docs/atlas/configure-alerts.md#std-label-configure-mw-alert)

## Begin Maintenance Now

To begin maintenance immediately:

1. In Atlas, go to the Project Settings page.

   If it's not already displayed, select the organization that contains your desired project from the  Organizations menu in the navigation bar.

   If it's not already displayed, select your desired project from the Projects menu in the navigation bar.

   In the sidebar, click the  icon next to Project Overview.

   The [Project Settings](https://cloud.mongodb.com/go?l=https%3A%2F%2Fcloud.mongodb.com%2Fv2%2F%3Cproject%3E%23%2Fsettings%2FgroupSettings) page displays.

2. Under the Database section in the left navigation, click Clusters.

3. In the maintenance banner, click View Details or View more scheduled maintenances.

   A modal window titled Scheduled Maintenance Operations appears, showing the scheduled date and time along with the types of maintenance operations planned.

4. In the maintenance banner, click Show Details. A modal window titled Scheduled Maintenance Operations appears, showing the scheduled date and time along with the types of maintenance operations planned.

5. In the Scheduled Maintenance Operations modal, click the Begin Now button. In the Start Cluster Maintenance Now confirmation modal, confirm by clicking Yes, start my maintenance now.

To update the maintenance window using the Atlas CLI, run the following command:

```sh

atlas maintenanceWindows update [options]

```

To learn more about the command syntax and parameters, see the Atlas CLI documentation for [atlas maintenanceWindows update.](https://www.mongodb.com/docs/atlas/cli/current/command/atlas-maintenanceWindows-update/)

IMPORTANT: To trigger maintenance immediately, pass the `--startASAP` option.

```Bash
# Trigger immediate maintenance for the project with the ID
# 5e2211c17a3e5a48f5497de3:

atlas maintenanceWindows update --startASAP --projectId 5e2211c17a3e5a48f5497de3 --output json
```

Atlas provides the [Update One Maintenance Window for One Project endpoint](https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updategroupmaintenancewindow). You can trigger maintenance immediately by passing in the optional `startASAP` field with a value of `true`.

**Note:**

This `curl` command uses a service account access token ([OAuth 2.0](https://oauth.net/2/)) to authenticate instead of API keys. To learn more, see [Get Started with the Atlas Administration API.](https://www.mongodb.com/docs/atlas/configure-api-access.md#std-label-atlas-admin-api-access)

```bash
curl --header "Authorization: Bearer {ACCESS-TOKEN}" \
  --include \
  --header "Accept: application/vnd.atlas.2025-03-12+json" \
  --header "Content-Type: application/json" \
  -X PATCH "https://cloud.mongodb.com/api/atlas/v2/groups/{groupId}/maintenanceWindow" \
  --data '
    {
      "startASAP": true
    }'
```

## Defer Maintenance

Use the following procedure to defer currently scheduled maintenance by one week. To automatically defer all future maintenance, enable [auto-defer.](https://www.mongodb.com/docs/atlas/tutorial/cluster-maintenance-window.md#std-label-auto-defer-maintenance)

**Note: Deferring Maintenance with Maintenance Waves Configured**

You can only manually defer maintenance for projects with a maintenance wave configured if they are assigned to Last Wave. Atlas limits these projects to at most one manual deferral.

**Note:**

You can defer a single project maintenance event up to two times.

To defer scheduled maintenance:

1. In Atlas, go to the Project Settings page.

   If it's not already displayed, select the organization that contains your desired project from the  Organizations menu in the navigation bar.

   If it's not already displayed, select your desired project from the Projects menu in the navigation bar.

   In the sidebar, click the  icon next to Project Overview.

   The [Project Settings](https://cloud.mongodb.com/go?l=https%3A%2F%2Fcloud.mongodb.com%2Fv2%2F%3Cproject%3E%23%2Fsettings%2FgroupSettings) page displays.

2. Under the Database section in the left navigation, click Clusters.

3. In the maintenance banner, click View Details or View more scheduled maintenances.

   A modal window titled Scheduled Maintenance Operations appears, showing the scheduled date and time along with the types of maintenance operations planned.

4. In the Scheduled Maintenance Operations modal, click the Defer 1 Week button. In the Defer Maintenance to Next Week confirmation modal, confirm by clicking Yes, defer maintenance until next week.

To defer the maintenance window using the Atlas CLI, run the following command:

```sh

atlas maintenanceWindows defer [options]

```

To learn more about the command syntax and parameters, see the Atlas CLI documentation for [atlas maintenanceWindows defer.](https://www.mongodb.com/docs/atlas/cli/current/command/atlas-maintenanceWindows-defer/)

Atlas provides the [Defer One Maintenance Window for One Project endpoint.](https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-defergroupmaintenancewindow)
