Skip to main content

Maintenance Mode

Maintenance Mode allows you to temporarily exclude managed clusters from health monitoring and alerting when performing planned maintenance activities. This feature helps prevent false alerts during scheduled maintenance windows while ensuring monitoring is automatically restored after the maintenance period. You maintain full control to disable maintenance mode at any time. The Argo CD applications continue to sync and deploy normally and the cluster remains operational for application workloads.

Enabling Maintenance Mode​

To enable maintenance mode for a managed cluster:

  1. Navigate to your Argo CD instance → Clusters tab.

  2. Find the cluster you want to put into maintenance mode.

  3. Under the Actions column, click on the three-dot button.

  4. Locate the Enable Maintenance Mode section.

    Maintenance Mode Section

  5. Enter the expiration day and time for maintenance mode. This is the date and time when maintenance mode will automatically expire and monitoring will be restored.

  6. Click Save to apply the changes.

    Maintenance Mode Modal

Once enabled, the cluster will be excluded from health monitoring and alerting. The 🔧 icon indicates that the cluster is in maintenance mode.

Cluster in Maintenance Mode

Disabling Maintenance Mode​

Maintenance mode can be disabled in the following ways:

Automatic Expiration​

Maintenance mode will be automatically disabled after the expiration time that you set to ensure monitoring is restored. If maintenance activities require more time, you will need to manually re-enable maintenance mode.

Manual Disabling​

To manually disable maintenance mode before the expiration time:

  1. Navigate to the cluster actions as described above.

  2. Locate the Disable Maintenance Mode section.

  3. Click Disable to apply the changes.

    Disable Maintenance Mode Modal