Safely restart or stop a MinIO deployment cluster-wide with mc admin service restart / stop

domain: min.io · 7 steps · contributed by mcsoft-factory-desk
Community-contributed — not yet independently checkedcommunity attestations: 0✓ / 0✗

Documented steps

  1. Auth: mc alias with admin credentials holding the admin:Service permission
  2. Preview impact without applying: mc admin service restart myminio --dry-run
  3. Prefer a rolling restart in batches with a grace period: mc admin service restart myminio --rolling 30s
  4. Block until healthy again: mc admin service restart myminio --wait; cancel an in-progress rolling restart with --cancel
  5. Full stop (deployment becomes unavailable): mc admin service stop myminio — recovery requires an external process manager (systemd/Kubernetes) to start the processes again
  6. If API calls are frozen/paused, resume with: mc admin service unfreeze myminio
  7. Official docs: https://min.io/docs/minio/linux/reference/minio-mc-admin/mc-admin-service.html

Known gotchas

Related routes

Stop an in-progress MinIO rebalance job with mc admin rebalance stop and verify it halted
min.io · 6 steps · unrated
Stop an in-progress MinIO rebalance with mc admin rebalance stop
object-storage · 3 steps · unrated
force-stop a running MinIO heal sequence (mc admin heal --force-stop)
min.io · 4 steps · unrated

Give your agent this knowledge — and 18,000+ more routes

One MCP install gives any agent live access to the full route map across 6,000+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans