MinIO Commandline Parameters Cheatsheet

Useful MinIO Commands

Page content

MinIO provides two standard UIs: (1) MinIO Console - That’s a web UI, and (2) MinIO Command - this is a commandline util mc.

If you are maintaining legacy MinIO CE environments, pair this command reference with MinIO CE end of life in 2026 to plan migration and risk controls.

Installation instructions are on MinIO website: https://min.io/docs/minio/linux/reference/minio-mc.html#install-mc

topimage This happy reader image is generated by AI model Flux 1 dev.

MinIO Command Line Cheatsheet

And here is a quick MinIO commands reference:

Basic Setup

  • Set an alias to a MinIO server:
    mc alias set myminio http://localhost:9000  
    
  • List buckets and directories:
    mc ls myminio
    mc ls myminio/bucket/folder
    

File Operations

  • Copy files to/from MinIO:
    mc cp source-path myminio/bucket/destination-path
    mc cp myminio/bucket/source-path destination-path
    
  • Mirror (sync) directories:
    mc mirror source-dir myminio/bucket
    mc mirror myminio/bucket destination-dir
    
  • Remove objects or buckets:
    mc rm myminio/bucket/object
    mc rb myminio/bucket
    
  • Move objects:
    mc mv myminio/bucket/source-object myminio/bucket/destination-object
    

Bucket and Object Management

  • Make a new bucket:
    mc mb myminio/new-bucket
    
  • List object info:
    mc stat myminio/bucket/object
    
  • Set bucket policy:
    mc policy set  myminio/bucket
    
  • Get bucket or object policy:
    mc policy get myminio/bucket
    mc policy get myminio/bucket/folder
    

User and Policy Management (Admin)

  • List policies:
    mc admin policy list myminio
    
  • Add a policy:
    mc admin policy add myminio policy-name /path/to/policy.json
    
  • List users:
    mc admin user list myminio
    
  • Add a user:
    mc admin user add myminio newuser newuser123
    
  • Assign a policy to a user:
    mc admin policy set myminio policy-name user=newuser
    
  • Disable a user:
    mc admin user disable myminio newuser
    
  • Remove a user:
    mc admin user remove myminio newuser
    

Lifecycle and Versioning

  • Set bucket lifecycle:
    mc ilm import myminio/bucket-name < ./path/to/lifecycle.json
    
  • List bucket lifecycles:
    mc ilm ls myminio/bucket-name
    

Other Useful Commands

  • Disk usage summary:
    mc du myminio/bucket
    
  • Tree view of bucket:
    mc tree myminio/bucket
    
  • Watch for events:
    mc watch myminio/bucket
    
  • Generate a presigned URL:
    mc share download myminio/bucket/object
    mc share upload myminio/bucket/object
    

Global Options

  • Use --json for JSON output:
    mc --json ls myminio
    
  • Use --insecure to skip TLS certificate verification (not recommended for production):
    mc --insecure ls myminio
    

Pattern Matching

  • Use * and ? wildcards for matching multiple objects or prefixes. For example:
    mc ls myminio/bucket/*.jpg
    mc rm myminio/bucket/file-?.txt
    

Subscribe

Get new posts on AI systems, Infrastructure, and AI engineering.