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.

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