Command Quick Reference

Command quick reference

The following table lists all top-level mc commands, excluding the mc admin commands.

CommandDescription
mc aliasThe mc alias commands provide a convenient interface for managing the list of S3-compatible hosts that mc can connect to and run operations against.
mc anonymousThe mc anonymous command supports setting or removing anonymous policies to a bucket and its contents. Buckets with anonymous policies allow public access where clients can perform any action granted by the policy without authentication.
mc batchThe mc batch commands allow you to run one or more job tasks on a MinIO AIStor deployment.
mc catThe mc cat command concatenates the contents of a file or object to another file or object. You can also use the command to display the contents of the specified file or object to STDOUT. cat has similar functionality to cat.
mc cpThe mc cp command copies objects to or from a MinIO AIStor deployment, where the source can MinIO AIStor or a local filesystem.
mc diffThe mc diff command computes the differences between two filesystem directories or MinIO AIStor buckets. mc diff lists only those objects which are missing or which differ in size. mc diff does not compare the contents of objects.
mc duThe mc du command summarizes the disk usage of buckets and folders. You can also use du against the local filesystem to produce similar results as the du command.
mc encryptThe mc encrypt commands set, update, or disable the default bucket Server-Side Encryption (SSE) mode. MinIO AIStor automatically encrypts objects using the specified SSE mode.
mc eventThe mc event command supports adding, removing, and listing bucket event notifications.
mc findThe mc find command supports searching for objects on a MinIO AIStor deployment.
You can also use the command to search for files on a filesystem.
mc getThe mc get command downloads an object from a target S3 deployment to the local file system.
mc headThe mc head command displays the first n lines of an object, where n is an argument specified to the command.
mc idp ldapThe mc idp ldap commands allow you to manage configurations to 3rd party Active Directory or LDAP Identity and Access Management (IAM) integrations.
mc idp openidThe mc idp openid commands allow you to manage configurations to 3rd party OpenID Identity and Access Management (IAM) integrations.
mc idp ldap policyThe mc idp ldap policy commands show the mapping relationships between policies and the associated groups or users.
mc ilm ruleThe mc ilm commands manage object lifecycle management rules on a MinIO AIStor deployment.
mc ilm tierThe mc ilm commands manage tiering on a MinIO AIStor deployment.
mc legalholdThe mc legalhold command sets, removes, or retrieves the object legal hold (WORM) settings for object(s).
mc licenseThe mc license commands work with cluster registration for MinIO SUBNET. Use the commands to register a deployment, display information about the cluster’s current license, or update the license key for a cluster.
mc lsThe mc ls command lists buckets and objects on MinIO AIStor or another S3-compatible service.
mc mbThe mc mb command creates a new bucket or directory at the specified path.
mc mirrorThe mc mirror command synchronizes content to MinIO AIStor deployment, similar to the rsync utility.
mc mirror supports filesystems, MinIO AIStor deployments, and other S3-compatible hosts as the synchronization source.
mc mvThe mc mv command moves an object from source to the target, such as between MinIO AIStor deployments or between buckets on the same MinIO AIStor deployment. mc mv also supports moving objects between a local filesystem and MinIO AIStor.
mc odThe mc od command copies a local file to a remote location in a specified number of parts and part sizes. The command outputs the time it took to upload the file.
mc pingThe mc ping command performs a liveness check on a specified target.
mc pipeThe mc pipe command streams content from STDIN to a target object.
mc putThe mc put uploads an object from the local file system to a bucket on a target S3 deployment.
mc quotaThe mc quota commands configure, display, or clear a hard quota on a bucket. This command replaces the deprecated mc admin bucket quota.
mc rbThe mc rb command removes one or more buckets on MinIO AIStor or another S3-compatible service.

To remove only the contents of a bucket, use mc rm instead.
mc readyThe mc ready command checks the status of a cluster and whether the cluster has read and write quorum.
mc replicateThe mc replicate command configures and manages the Server-Side Bucket Replication for a MinIO AIStor deployment, including active-active replication configurations and resynchronization.
mc retentionThe mc retention command configures the Write-Once Read-Many (WORM) locking settings for an object or object(s) in a bucket. You can also set the default object lock settings for a bucket, where all objects without explicit object lock settings inherit the bucket default.
mc rmThe mc rm command removes objects from a bucket on a MinIO AIStor deployment. To completely remove a bucket, use mc rb instead.
mc shareUse the mc share commands to manage presigned URLs for downloading and uploading objects to a MinIO AIStor bucket.
mc sqlThe mc sql command provides an S3 Select interface for performing sql queries on objects in the specified MinIO AIStor deployment.
mc statThe mc stat command displays information on objects in a MinIO AIStor bucket, including object metadata. You can also use it to retrieve bucket metadata.
mc supportThe AIStor Client mc support commands provide tools for analyzing deployment health or performance and for running diagnostics. You can also upload generated health reports for further analysis by MinIO AIStor engineering.
mc tagThe mc tag command adds, removes, and lists tags associated to a bucket or object.
mc treeThe mc tree command lists all prefixes inside a MinIO AIStor bucket in a tree format. The command optionally supports listing all objects inside of bucket at each prefix, including the bucket root.
mc undoThe mc undo command reverses changes due to either a PUT or DELETE operation at a specified path.
mc updateThe mc update command automatically updates the mc binary to the latest stable version.
mc versionThe mc version commands enable, disable, and retrieve the versioning status for a MinIO AIStor bucket.
mc watchThe mc watch command watches for events on the specified MinIO AIStor bucket or local filesystem path. For S3 services, use mc event add to configure bucket event notifications on S3-compatible services.

On this page