mc
provides minimal tools to work with Amazon S3 compatible cloud storage and filesystems. It has features like resumable uploads/downloads, progress bar, parallel copy. mc
is written in golang and released under Apache license v2.
mc
implements the following commands
ls List files and folders.
mb Make a bucket or folder.
cat Display contents of a file.
pipe Write contents of stdin to one or more targets. When no target is specified, it writes to stdout.
share Generate URL for sharing.
cp Copy one or more objects to a target.
mirror Mirror folders recursively from a single source to many destinations.
diff Compute differences between two folders.
rm Remove file or bucket [WARNING: Use with care].
access Manage bucket access permissions.
session Manage saved sessions of cp and mirror operations.
config Manage configuration file.
update Check for a new software update.
version Print version.
Download mc
for:
64-bit Intel
from https://dl.minio.io/client/mc/release/linux-amd64/mc32-bit Intel
from https://dl.minio.io/client/mc/release/linux-386/mc32-bit ARM
from https://dl.minio.io/client/mc/release/linux-arm/mc
$ chmod +x mc
$ ./mc --help
Download mc
from https://dl.minio.io/client/mc/release/darwin-amd64/mc
$ chmod 755 mc
$ ./mc --help
Download mc
for:
64-bit
from https://dl.minio.io/client/mc/release/windows-amd64/mc.exe32-bit
from https://dl.minio.io/client/mc/release/windows-386/mc.exe
C:\Users\Username\Downloads> mc.exe --help
NOTE: Source installation is intended for only developers and advanced users. ‘mc update’ continous delivery mechanism is not supported for ‘go get’ based binary builds. Please download official releases from https://minio.io/#mc.
If you do not have a working Golang environment, please follow Install Golang.
$ GO15VENDOREXPERIMENT=1 go get -u github.com/minio/mc
Minio cloud storage server is hosted at https://play.minio.io:9000
for public use. This service is primarily intended for developers and users to familiarize themselves with Amazon S3 compatible cloud storage. Minio runs with filesystem backend with auto-expiry for objects in about 24 hours. No account signup is required, which means S3 compatible tools and applications can access this service without access and secret keys.
Get your AccessKeyID and SecretAccessKey by following AWS Credentials Guide.
Once you have them update your ~/.mc/config.json
configuration file.
$ mc config host add <ALIAS> <YOUR-S3-ENDPOINT> <YOUR-ACCESS-KEY> <YOUR-SECRET-KEY> S3v4
Example
$ mc config host add mys3 https://s3.amazonaws.com BKIKJAA5BMMU2RHO6IBB V7f1CwQqAcwo80UEIJEjc5gVQUSSx5ohQ9GSrr12
NOTE: S3v4
is default if not specified.
Get your AccessKeyID and SecretAccessKey by following Google Credentials Guide.
Once you have them update your ~/.mc/config.json
configuration file.
$ mc config host add <ALIAS> https://storage.googleapis.com <YOUR-ACCESS-KEY> <YOUR-SECRET-KEY> S3v2
NOTE: Google Cloud Storage only supports Legacy Signature Version 2
, so you have to pick - S3v2
Please follow Minio Contributor's Guide
If you think in Lisp or Haskell and hack in go, you would blend right in. Send your github link to callhome@minio.io.