mc 0,0 travis-ci

Minio Client is a replacement for ls, cp, mkdir, diff and rsync commands for filesystems and object storage.

Minio Client Quickstart Guide Gitter

Minio Client (mc) provides a modern alternative to UNIX commands like ls, cat, cp, mirror, diff etc. It supports filesystems and Amazon S3 compatible cloud storage service (AWS Signature v2 and v4).


ls            List files and folders.
mb            Make a bucket or folder.
cat           Display contents of a file.
pipe          Write contents of stdin to target. 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 single destination.
diff          Compute differences between two folders.
rm            Remove file or bucket [WARNING: Use with care].
events        Manage bucket notification.
watch         Watch for events on object storage and filesystem.
policy	      Set public policy on bucket or prefix.
session       Manage saved sessions of cp and mirror operations.
config        Manage configuration file.
update        Check for a new software update.
version       Print version.

1. Download Minio Client

Platform Architecture URL
GNU/Linux 64-bit Intel https://dl.minio.io/client/mc/release/linux-amd64/mc
32-bit Intel https://dl.minio.io/client/mc/release/linux-386/mc
32-bit ARM https://dl.minio.io/client/mc/release/linux-arm/mc
Apple OS X 64-bit Intel https://dl.minio.io/client/mc/release/darwin-amd64/mc
Microsoft Windows 64-bit https://dl.minio.io/client/mc/release/windows-amd64/mc.exe
32-bit https://dl.minio.io/client/mc/release/windows-386/mc.exe
FreeBSD 64-bit https://dl.minio.io/client/mc/release/freebsd-amd64/mc
Solaris/Illumos 64-bit https://dl.minio.io/client/mc/release/solaris-amd64/mc

Install from Homebrew

Install minio packages using Homebrew

$ brew install minio-mc
$ mc --help

Install from Source

Source installation is intended only for developers and advanced users. mc update command does not support upgrading from source based installation. Please download official releases from https://minio.io/downloads/#minio-client.

If you do not have a working Golang environment, please follow How to install Golang.


$ go get -u github.com/minio/mc

2. Run Minio Client

GNU/Linux


$ chmod +x mc
$ ./mc --help

OS X


$ chmod 755 mc
$ ./mc --help

Microsoft Windows


C:\Users\Username\Downloads> mc.exe --help

Solaris/Illumos


$ chmod 755 mc
$ ./mc --help

FreeBSD


$ chmod 755 mc
$ ./mc --help

3. Add a Cloud Storage Service

Note: If you are planning to use mc only on POSIX compatible filesystems, you may skip this step and proceed to Step 4.

To add one or more Amazon S3 compatible hosts, please follow the instructions below. mc stores all its configuration information in ~/.mc/config.json file.

Usage


mc config host add <ALIAS> <YOUR-S3-ENDPOINT> <YOUR-ACCESS-KEY> <YOUR-SECRET-KEY> <API-SIGNATURE>

Alias is simply a short name to you cloud storage service. S3 end-point, access and secret keys are supplied by your cloud storage provider. API signature is an optional argument. By default, it is set to “S3v4”.

Example - Minio Cloud Storage

Minio server displays URL, access and secret keys.


$ mc config host add minio http://192.168.1.51 BKIKJAA5BMMU2RHO6IBB V7f1CwQqAcwo80UEIJEjc5gVQUSSx5ohQ9GSrr12 S3v4

Example - Amazon S3 Cloud Storage

Get your AccessKeyID and SecretAccessKey by following AWS Credentials Guide.


$ mc config host add s3 https://s3.amazonaws.com BKIKJAA5BMMU2RHO6IBB V7f1CwQqAcwo80UEIJEjc5gVQUSSx5ohQ9GSrr12 S3v4

Example - Google Cloud Storage

Get your AccessKeyID and SecretAccessKey by following Google Credentials Guide


$ mc config host add gcs  https://storage.googleapis.com BKIKJAA5BMMU2RHO6IBB V8f1CwQqAcwo80UEIJEjc5gVQUSSx5ohQ9GSrr12 S3v2

NOTE: Google Cloud Storage only supports Legacy Signature Version 2, so you have to pick - S3v2

4. Test Your Setup

mc is pre-configured with https://play.minio.io:9000, aliased as “play”. It is a hosted Minio server for testing and development purpose. To test Amazon S3, simply replace “play” with “s3” or the alias you used at the time of setup.

Example:

List all buckets from https://play.minio.io:9000


$ mc ls play
[2016-03-22 19:47:48 PDT]     0B my-bucketname/
[2016-03-22 22:01:07 PDT]     0B mytestbucket/
[2016-03-22 20:04:39 PDT]     0B mybucketname/
[2016-01-28 17:23:11 PST]     0B newbucket/
[2016-03-20 09:08:36 PDT]     0B s3git-test/

5. Everyday Use

You may add shell aliases to override your common Unix tools.


alias ls='mc ls'
alias cp='mc cp'
alias cat='mc cat'
alias mkdir='mc mb'
alias pipe='mc pipe'

6. Explore Further

7. Contribute

Contributors Guide

Related Repositories

mc

mc

Midnight Commander's repository ...

mc

mc

Minio Client is a replacement for ls, cp, mkdir, diff and rsync commands for filesystems and object storage. ...

Wurst-Client-for-MC-1.8.X

Wurst-Client-for-MC-1.8.X

:boom: Wurst Client for Minecraft 1.8.X ...

evil-mc

evil-mc

Multiple cursors implementation for evil-mode ...

mc-benchmark

mc-benchmark

Memcache port of Redis benchmark ...


Top Contributors

harshavardhana abperiasamy vadmeste krishnasrinivas koolhead17 krisis deekoder mkash32 nl5887 sreeram-boyapati balamurugana hackintoshrao Flimm bosky101 awwalker arschles winchram fwessels

Releases

-   RELEASE.2016-10-07T0 zip tar
-   RELEASE.2016-08-21T0 zip tar
-   RELEASE.2016-08-18T0 zip tar
-   RELEASE.2016-07-13T2 zip tar
-   RELEASE.2016-06-03T1 zip tar
-   RELEASE.2016-04-01T0 zip tar
-   RELEASE.2016-02-19T0 zip tar
-   RELEASE.Wed-Jun-24-2 zip tar
-   RELEASE.Wed-Jun-17-0 zip tar
-   RELEASE.Wed-Aug-26-1 zip tar
-   RELEASE.Tue-Sep-22-0 zip tar
-   RELEASE.Sat-Sep-05-2 zip tar
-   RELEASE.Sat-Sep-05-2 zip tar
-   RELEASE.Mon-05-Oct-2 zip tar
-   OFFICIAL.2016-02-08T zip tar
-   OFFICIAL.2016-01-07T zip tar
-   OFFICIAL.2015-12-06T zip tar
-   OFFICIAL.2015-12-01T zip tar
-   OFFICIAL.2015-11-30T zip tar