Skip to content

fwessels/mc

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Minio Client (mc) Gitter

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.

Commands

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.

Install Build Status Build status

GNU/Linux

Download mc for:

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

OS X

Download mc from https://dl.minio.io/client/mc/release/darwin-amd64/mc

$ chmod 755 mc
$ ./mc --help

Microsoft Windows

Download mc for:

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

Source

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

Public Minio Server

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.

Configuring mc for Amazon S3

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.

Configure mc for Google Cloud Storage

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

Contribute to Minio Client

Please follow Minio Contributor's Guide

Jobs

If you think in Lisp or Haskell and hack in go, you would blend right in. Send your github link to callhome@minio.io.

About

Minio Client for filesystem and cloud storage

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Go 96.8%
  • Shell 2.5%
  • Other 0.7%