Skip to content

mc admin update

Description

The mc admin update command invokes the MinIO-compatible server-side in-place update API. The client can pass an optional release mirror URL, and the server distributes the selected binary to all nodes.

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.

Caution

Do not use the default update path on Silo

As of 2026-08-05, the latest published Silo server (RELEASE.2026-08-04T00-00-00Z) still resolves an omitted MIRROR_URL through the upstream dl.min.io release feed and retains the upstream MinIO signing key. Running mc admin update ALIAS against an update-enabled Silo server can therefore replace Silo with an upstream MinIO binary.

Set MINIO_UPDATE=off on Silo servers and upgrade through Download & Install, a trusted package repository, or a manually verified Silo artifact. This page retains the command contract for compatibility; it is not the recommended Silo upgrade procedure.

Note

Use mc admin on Silo or compatible MinIO deployments only

mc admin uses MinIO-specific administration APIs. General S3 API compatibility alone does not imply that another object store supports these commands.

Considerations

Coordinated Restart

mc admin update updates the binary and restarts all servers in the deployment simultaneously. Applications should expect a temporary loss of availability and retry failed or interrupted requests; atomic object operations do not make a full-cluster restart invisible.

Use a coordinated upgrade-and-restart procedure. Do not perform a rolling (one node at a time) binary replacement unless the release documentation explicitly states that mixed versions are supported.

Permissions

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

Examples

The inherited default form below is shown only to identify the command contract. Do not run it against Silo, because omitting MIRROR_URL selects the upstream MinIO update feed:

mc admin update ALIAS

Replace ALIAS with the alias of the target 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 release-manifest URL used by the target server to locate the minio binary. Supplying a URL does not make an artifact trusted; verify the complete update and signature contract before using this compatibility path. Silo operators should prefer the documented package or manual upgrade procedure.

--yes, -y

mc-cmd

Optional

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

Behavior

Binary Compression

Note

Changed: RELEASE.2024-01-28T22-35-53Z

mc admin update compresses the binary before sending to all nodes in the deployment.

This feature does not apply to systemctl managed deployments.