mc admin cluster bucket import

Description

The mc admin cluster bucket import command imports bucket metadata as created by the mc admin cluster bucket export command.

You can use this command to manually restore the metadata to the specified bucket on a MinIO deployment.

If you specify only the deployment as the target, this command applies the metadata objects to all matching buckets on the target.

The following command imports the specified metadata to the myminio deployment.

mc admin cluster bucket import myminio ~/minio-metadata-backup/myminio-cluster.zip

The command has the following syntax:

mc [GLOBALFLAGS] admin cluster bucket import  \
                                    ALIAS[/BUCKET] \
                                    METADATA.ZIP
  • Brackets [] indicate optional parameters.
  • Parameters sharing a line are mutually dependent.
  • Parameters separated using the pipe | operator are mutually exclusive.

Copy the example to a text editor and modify as-needed before running the command in the terminal/shell.

Parameters

ALIAS

mc-cmd

Required

The alias of the MinIO deployment.

METADATA.ZIP

mc-cmd

Required

The path to the metadata file to import.

Use mc admin cluster bucket export to export bucket metadata for use with this command.

BUCKET

mc-cmd

Optional

The bucket to apply the imported metadata to.

Global Flags

This command supports any of the global flags.

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