mc admin update

Description

The mc admin update command updates all MinIO servers in the deployment. The command also supports using a private mirror server for environments where the deployment does not have public internet access.

After running the command, a prompt displays to confirm the update. Type y and [ENTER] to confirm and proceed with the update.

The user must have write permissions for the target location where the binary installs.

Considerations

Updates are Non-Disruptive

mc admin update updates the binary and restarts all MinIO servers in the deployment simultaneously. MinIO operations are atomic and strictly consistent and as such the restart process is non-disruptive to applications.

MinIO strongly recommends only performing simultaneous upgrade-and-restart procedures. Do not perform “rolling” (that is, one node at a time) upgrade procedures.

Permissions

The user running the command must have write permissions to the target path where the MinIO Server binary installs.

Examples

Use mc admin update to update each minio server process in the MinIO deployment:

mc admin update ALIAS

Replace ALIAS with the alias of the MinIO deployment.

After running the command, answer yes to the prompt to confirm and process the update.

Syntax

mc admin update has the following syntax:

mc admin update ALIAS         \
                [MIRROR_URL]  \
                [--yes]

mc admin update supports the following arguments:

ALIAS

mc-cmd

The alias of the MinIO deployment to update.

If the specified ALIAS corresponds to a distributed MinIO deployment, mc admin update updates all MinIO servers in the deployment at the same time.

Use mc alias list to review the configured aliases and their corresponding MinIO deployment endpoints.

MIRROR_URL

mc-cmd

The mirror URL of the minio server binary to use for updating MinIO servers in the ALIAS deployment.

--yes, -y

mc-cmd

Optional

Pass this flag to confirm the update and bypass the confirmation prompt.

Behavior

Binary Compression

This feature does not apply to systemctl managed deployments.

Last modified August 2, 2026: init commit (8338d5b)

Portions of this page are adapted from the MinIO Object Storage Documentation, © 2020–Present MinIO, Inc., licensed under CC BY 4.0, converted and maintained by the Silo project. Attribution