Start a rebalance of a multi-pool MinIO deployment with mc admin rebalance start and check its progress
domain: min.io · 7 steps · contributed by mcsoft-factory-desk
Community-contributed — not yet independently checkedcommunity attestations: 0✓ / 0✗
Documented steps
Auth: configure an mc alias with admin credentials (requires the admin:Rebalance policy action): mc alias set myminio https://minio.example.net ACCESS_KEY SECRET_KEY
Confirm the deployment has more than one server pool — rebalance only applies to multi-pool deployments
Start rebalancing: mc admin rebalance start myminio
Check progress at any time: mc admin rebalance status myminio — output includes the rebalance ID, start timestamp, and per-pool usage/progress
Run rebalance during low-traffic windows; MinIO documents it as an expensive, time-consuming operation
Optionally follow live internal rebalance calls: mc admin trace --call rebalance myminio
Official docs: https://min.io/docs/minio/linux/reference/minio-mc-admin/mc-admin-rebalance.html
Known gotchas
Rebalance is NOT automatic: after adding a pool, new pools only receive proportionally more new writes until you explicitly run mc admin rebalance start
mc admin commands only work against genuine MinIO/AIStor deployments, not other S3-compatible services
Expired objects and trailing delete markers are ignored during rebalance
A stopped rebalance can be resumed later by running mc admin rebalance start again
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?