Skip to main content
By the end of this guide, you’ll have maintenance windows configured to suppress alerts during planned deployments and infrastructure changes.
  • DevHelm CLI installed or an API token
  • At least one monitor running
For conceptual background, see Maintenance windows.

​
Create a one-time window

1

Schedule the window

devhelm maintenance-windows create \
  --monitor-id <monitor-id> \
  --starts-at "2026-04-15T02:00:00Z" \
  --ends-at "2026-04-15T04:00:00Z" \
  --reason "Database migration"
Omit --monitor-id to create an organization-wide window.
2

Verify it's scheduled

devhelm maintenance-windows list --filter upcoming

​
Create a recurring window

For weekly maintenance, use an iCal RRULE: 
curl -X POST https://api.devhelm.io/api/v1/maintenance-windows \
  -H "Authorization: Bearer $DEVHELM_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "startsAt": "2026-04-15T02:00:00Z",
    "endsAt": "2026-04-15T04:00:00Z",
    "repeatRule": "FREQ=WEEKLY;BYDAY=TU",
    "reason": "Weekly infrastructure maintenance",
    "suppressAlerts": true
  }'
Common patterns:
ScheduleRRULE
Every Tuesday 2-4 AM UTCFREQ=WEEKLY;BYDAY=TU
First day of each monthFREQ=MONTHLY;BYMONTHDAY=1
Every other SaturdayFREQ=WEEKLY;BYDAY=SA;INTERVAL=2

​
Deployment-triggered windows

Create a short maintenance window as part of your deployment process: 
START=$(date -u +%Y-%m-%dT%H:%M:%SZ)
END=$(date -u -d '+30 minutes' +%Y-%m-%dT%H:%M:%SZ)

devhelm maintenance-windows create \
  --starts-at "$START" \
  --ends-at "$END" \
  --reason "Production deployment $(git rev-parse --short HEAD)"
For CI/CD integration, add this as a pre-deploy step in your pipeline. See CI/CD pipeline guide.

​
Extend or cancel

If maintenance takes longer than expected: 
devhelm maintenance-windows update <window-id> \
  --ends-at "2026-04-15T06:00:00Z" \
  --reason "Extended — migration still in progress"
To end early: 
devhelm maintenance-windows delete <window-id>

​
What happens during a window

  • Monitoring continues — checks still run and results are recorded
  • Alert suppression kicks in when suppressAlerts: true
  • Incidents created during the window get severity MAINTENANCE
  • Once the window closes, normal alerting resumes immediately

​
Next steps

Maintenance windows reference

Full configuration options and recurring patterns.

Alert suppression

Other suppression mechanisms beyond maintenance windows.

CI/CD pipeline

Automate maintenance windows in your deploy pipeline.