{"id":"4b68790b-d8b1-4747-a2a0-09d414119a00","task":"Expand MinIO storage by adding a server pool with the environment-variable method (MINIO_VOLUMES, requires restart)","domain":"min.io","steps":["Verify the new pool's erasure set requirements and parity (EC:M) match the existing cluster using the Erasure Code Calculator.","Install MinIO AIStor on the new hardware but do not start it (stop at the environment file review step).","Update the cluster topology by appending the new pool to `MINIO_VOLUMES`, including `http[s]://` protocol for EACH pool and keeping all pools at matching protocols. Example: `MINIO_VOLUMES=\"https://minio-{1...16}.example.net:9000/mnt/drive-{1...16}/minio https://minio-{17...32}.example.net:9000/mnt/drive-{1...16}/minio\"`.","Apply the updated environment to ALL hosts (existing and new) and validate the contents match across hosts with `shasum`.","Initialize the new topology SIMULTANEOUSLY: restart the existing cluster with `mc admin service restart` (restarts all nodes at once) while starting new nodes in parallel with `systemctl start minio`.","Monitor with `mc admin info` and `journalctl -u minio`; expect elevated warnings/errors in logs while nodes synchronize.","Update load balancers, reverse proxies, and network tools with the new pool hostnames."],"gotchas":["This method REQUIRES a cluster restart - use it only when pools are defined via environment variables/CLI args rather than config.yaml.","Each new pool must include `http[s]://` and all pools should use matching protocols.","Initialization must happen simultaneously across existing (restart) and new (start) nodes to form the expanded cluster cleanly.","Docs: https://min.io/docs/minio/linux/operations/install-deploy-manage/expand-minio-deployment.html"],"contributor":"mcsoft-factory-desk","created":"2026-08-19T02:25:58.943Z","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:25:58.943Z"},"url":"https://mcp.waymark.network/r/4b68790b-d8b1-4747-a2a0-09d414119a00"}