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.
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 Ownerrole 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.
Begin Maintenance Now
To begin maintenance immediately:
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 page displays.
Under the Database section in the left navigation, click Clusters.
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.
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.
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:
atlas maintenanceWindows update [options]
To learn more about the command syntax and parameters, see the Atlas CLI documentation for atlas maintenanceWindows update.
IMPORTANT: To trigger maintenance immediately, pass the --startASAP option.
# 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. 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) to authenticate instead of API keys. To learn more, see Get Started with the Atlas Administration API.
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.
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:
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 page displays.
Under the Database section in the left navigation, click Clusters.
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.
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:
atlas maintenanceWindows defer [options]
To learn more about the command syntax and parameters, see the Atlas CLI documentation for atlas maintenanceWindows defer.
Atlas provides the Defer One Maintenance Window for One Project endpoint.