No description
Find a file
2016-02-05 23:10:09 -08:00
buildscripts mc: Vendorize to new API changes. 2016-01-23 23:53:27 -08:00
pkg minio-go: Vendorize with new changes. 2016-02-05 23:10:09 -08:00
tests tests: Merge minio-tests into 'mc' 2015-12-02 16:32:48 -08:00
vendor minio-go: Vendorize with new changes. 2016-02-05 23:10:09 -08:00
.gitignore Add support for signature v2 - fixes #1111 2015-09-21 21:00:07 -07:00
.mailmap update AB's contributors email 2015-08-20 16:16:17 -07:00
.travis.yml urlAlias: Handle forward slashes on windows. 2016-01-27 14:34:12 -08:00
access-main.go ls: Make recursive and non-recursive behave the same way 2016-01-26 18:11:24 -08:00
access-perms.go cleanup: Cleanup across code base. 2015-11-08 13:22:32 -08:00
accounting-reader.go mc: Vendorize to new API changes. 2016-01-23 23:53:27 -08:00
api_handlers_test.go ls: Make recursive and non-recursive behave the same way 2016-01-26 18:11:24 -08:00
appveyor.yml ls: Make recursive and non-recursive behave the same way 2016-01-26 18:11:24 -08:00
build-constants.go fix short-commit-id to 12 digits 2015-11-27 11:26:09 -08:00
cat-main.go ls: Make recursive and non-recursive behave the same way 2016-01-26 18:11:24 -08:00
common-methods.go url: Error out if the aliased URL has host entry. 2016-02-01 02:41:04 -08:00
config-fix.go mc: Vendorize to new API changes. 2016-01-23 23:53:27 -08:00
config-host-main.go Make API argument in config host add cmd optional 2016-01-10 14:47:48 +01:00
config-main.go new alias style and numerous cleanups. 2015-12-28 15:31:52 -08:00
config-migrate.go new alias style and numerous cleanups. 2015-12-28 15:31:52 -08:00
config-old.go new alias style and numerous cleanups. 2015-12-28 15:31:52 -08:00
config-utils.go new alias style and numerous cleanups. 2015-12-28 15:31:52 -08:00
config-v7.go new alias style and numerous cleanups. 2015-12-28 15:31:52 -08:00
config.go ls: Make recursive and non-recursive behave the same way 2016-01-26 18:11:24 -08:00
CONTRIBUTING.md mc: Vendorize to new API changes. 2016-01-23 23:53:27 -08:00
CONTRIBUTORS.md update AB's contributors email 2015-08-20 16:16:17 -07:00
contributors.sh Add contributors file 2015-05-23 11:44:40 -07:00
cp-main.go progressBar: Finish progress bar if total is greater than 0 2016-02-01 13:36:23 -08:00
cp-url-syntax.go new alias style and numerous cleanups. 2015-12-28 15:31:52 -08:00
cp-url.go cp/mirror: Handle path constructions properly across operating systems. 2016-01-26 18:21:34 -08:00
damerau-levenshtein.go Add Damerau Levenshtein algo to suggest more alternatives to mistyped commmands 2016-01-13 21:32:23 +01:00
diff-main.go ls: Make recursive and non-recursive behave the same way 2016-01-26 18:11:24 -08:00
difference.go diff/mirror: Handle aliases properly now. 2016-01-08 21:24:07 -08:00
error.go ls: Make recursive and non-recursive behave the same way 2016-01-26 18:11:24 -08:00
flags.go global flags are replaced with command speific flags, but still retain global behavior 2015-11-21 14:20:00 -08:00
globals.go new alias style and numerous cleanups. 2015-12-28 15:31:52 -08:00
INSTALLGO.md mc: Vendorize to new API changes. 2016-01-23 23:53:27 -08:00
LICENSE Add Apache License v2.0 2015-01-17 12:09:27 -08:00
ls-main.go new alias style and numerous cleanups. 2015-12-28 15:31:52 -08:00
ls.go ls: On windows truncate the directory prefixes properly. 2016-01-25 21:34:16 -08:00
ls_test.go testing: Remove all the console IsExited/IsError testing. 2015-11-21 17:55:42 -08:00
main.go Add Damerau Levenshtein algo to suggest more alternatives to mistyped commmands 2016-01-13 21:32:23 +01:00
MAINTAINERS.md mc: Vendorize to new API changes. 2016-01-23 23:53:27 -08:00
Makefile mc: Vendorize to new API changes. 2016-01-23 23:53:27 -08:00
mb-main.go ls: Make recursive and non-recursive behave the same way 2016-01-26 18:11:24 -08:00
mc_test.go new alias style and numerous cleanups. 2015-12-28 15:31:52 -08:00
mirror-main.go progressBar: Finish progress bar if total is greater than 0 2016-02-01 13:36:23 -08:00
mirror-url.go diff/mirror: Handle aliases properly now. 2016-01-08 21:24:07 -08:00
NOTICE Rename all http references to https 2015-06-08 21:13:12 -07:00
notifier.go ls: Make recursive and non-recursive behave the same way 2016-01-26 18:11:24 -08:00
pipe-main.go mc: Vendorize to new API changes. 2016-01-23 23:53:27 -08:00
print.go restructure globals and some bug fixes related to globals 2015-11-21 12:43:21 -08:00
progress-bar.go mc: Vendorize to new API changes. 2016-01-23 23:53:27 -08:00
README.md Merge pull request #1544 from harshavardhana/merge-vendorize 2016-01-23 23:57:59 -08:00
release.cmd aliasconfig: Verify only os.PathSeparator contains not suffix. 2015-12-02 10:20:43 -08:00
release.sh release: Add release scripts. 2015-11-19 21:04:57 -08:00
rm-main.go cp/mirror: Handle path constructions properly across operating systems. 2016-01-26 18:21:34 -08:00
scan-bar.go ls: Make recursive and non-recursive behave the same way 2016-01-26 18:11:24 -08:00
session-main.go ls: Make recursive and non-recursive behave the same way 2016-01-26 18:11:24 -08:00
session-v6.go ls: Make recursive and non-recursive behave the same way 2016-01-26 18:11:24 -08:00
session.go ls: Make recursive and non-recursive behave the same way 2016-01-26 18:11:24 -08:00
session_test.go new alias style and numerous cleanups. 2015-12-28 15:31:52 -08:00
share-db-v1.go ls: Make recursive and non-recursive behave the same way 2016-01-26 18:11:24 -08:00
share-download-main.go mc: Vendorize to new API changes. 2016-01-23 23:53:27 -08:00
share-list-main.go organize global flags after cmd flag 2015-11-24 16:59:46 -08:00
share-main.go organize global flags after cmd flag 2015-11-24 16:59:46 -08:00
share-upload-main.go mc: Vendorize to new API changes. 2016-01-23 23:53:27 -08:00
share.go ls: Make recursive and non-recursive behave the same way 2016-01-26 18:11:24 -08:00
signals.go doc: Add various missing documentation across the codebase. 2015-11-18 12:52:46 -08:00
strings.go flicker free scanbar 2015-09-22 04:10:48 -07:00
time.go doc: Add various missing documentation across the codebase. 2015-11-18 12:52:46 -08:00
trie.go doc: Add various missing documentation across the codebase. 2015-11-18 12:52:46 -08:00
typed-errors.go url: Error out if the aliased URL has host entry. 2016-02-01 02:41:04 -08:00
update-main.go ls: Make recursive and non-recursive behave the same way 2016-01-26 18:11:24 -08:00
url.go url: Error out if the aliased URL has host entry. 2016-02-01 02:41:04 -08:00
url_test.go mc ls fails when there is a broken symlink - fixes #1442 2015-11-19 12:09:20 -08:00
utils.go pkg/user: Bring user package from server and use it here in place of userCurrent. 2015-12-08 20:35:01 -08:00
verify-runtime.go new alias style and numerous cleanups. 2015-12-28 15:31:52 -08:00
version-main.go organize global flags after cmd flag 2015-11-24 16:59:46 -08:00
version_test.go ls: Make recursive and non-recursive behave the same way 2016-01-26 18:11:24 -08:00

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 continuous 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.