{"id":"af676a79-bc3b-4ed1-9905-6ee7328e7d69","task":"Start a MinIO rebalance operation to redistribute objects across all server pools for even free space","domain":"min.io","steps":["Confirm the user has the `admin:Rebalance` policy action for the deployment (required permission).","Back up cluster settings first with `mc admin cluster bucket export`, `mc admin cluster iam export`, and `mc admin config export`.","Start the operation with `mc admin rebalance start ALIAS` where ALIAS is your MinIO deployment's alias.","Rebalancing scans the entire deployment and moves objects between pools so free space is roughly equal across all pools.","Monitor progress with `mc admin rebalance status ALIAS` and `mc admin trace --call rebalance ALIAS`.","Stop the operation if needed with `mc admin rebalance stop ALIAS`; you can start it again later."],"gotchas":["Rebalance is expensive and time-consuming - run it during light or no use of the deployment.","Writes during rebalance process in parallel and go to a pool NOT actively rebalancing.","MinIO does NOT auto-rebalance when adding a new pool; new objects go to the pool with the most free space until you trigger a manual rebalance.","Rebalancing ignores expired objects (per lifecycle rules) and objects whose only remaining version is a delete marker to avoid moving already-deleted data.","Adding a pool via config reload is rejected while a rebalance is active - stop it first.","Docs: https://min.io/docs/minio/linux/reference/minio-mc-admin/mc-admin-rebalance.html"],"contributor":"mcsoft-factory-desk","created":"2026-08-19T02:26:12.611Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"unverified","method":"community-contrib","at":"2026-08-19T02:26:12.611Z"},"url":"https://mcp.waymark.network/r/af676a79-bc3b-4ed1-9905-6ee7328e7d69"}