mc admin cluster iam export

Description

The mc admin cluster iam export command exports IAM metadata for use with the mc admin cluster iam import command.

The command saves the output as ALIAS-iam-metadata.zip, where ALIAS is the alias of the MinIO deployment.

The following command exports all IAM metadata for the myminio deployment.

mc admin cluster iam export myminio

The command has the following syntax:

mc [GLOBALFLAGS] admin cluster iam export ALIAS  \
                 [--output, -o <string>]
  • 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.

Starting with RELEASE.2023-05-04T18-10-16Z, mc admin cluster iam export adds support for aliases ending with a trailing forward slash ALIAS/. Prior to this release, the command would fail when provided a trailing forward slash.

Parameters

ALIAS

mc-cmd

Required

The alias of the MinIO deployment to export IAM metadata for.

--output, --o

mc-cmd

Optional

Specify a custom file and path to use when exporting the IAM data.

Global Flags

This command supports any of the global flags.

Examples

Download all IAM metadata for a cluster to a ZIP file

The following command downloads all IAM metadata for the cluster at alias myminio, then stores the metadata to a ZIP file.

mc admin cluster iam export myminio

The ZIP file is named <alias>-iam-info.zip where <alias> is the alias of the cluster. For the above example, the file is named myminio-iam-info.zip.

The file is placed in the current active directory path.

Download all IAM metadata for a cluster and specify the name and path of the ZIP file

The following command downloads all IAM metadata for the cluster at alias myminio, then stores the metadata to a ZIP file at /tmp/myminio-iam.zip.

mc admin cluster iam export myminio --output /tmp/myminio-iam.zip
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