You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 
Harshavardhana a84c466a40 Merge pull request #1251 from harshavardhana/release-fixes 9 years ago
buildscripts release: gz doesn't preserve permissions use tar.gz 9 years ago
docker docker: Fix docker command entry. 9 years ago
pkg Merge pull request #1265 from vadmeste/add_fbsd_support 9 years ago
vendor config/main: Re-write config files - add to new config v3 9 years ago
.gitignore build/vet: Fix all the shadowing reports with go1.6 9 years ago
.mailmap Update AB's duplicate email address 9 years ago
.travis.yml build/vet: Fix all the shadowing reports with go1.6 9 years ago
AWS-SDK-GO.md doc: Cleanup aws-sdk-go.md 9 years ago
Browser.md jwt: Deprecate RSA usage, use HMAC instead. 9 years ago
Bucket-Policy.md bucketpolicy: Improve bucket policy validation, avoid nested rules. 9 years ago
CONTRIBUTING.md Migrate this project to minio micro services code 9 years ago
Caddy.md Update Caddy.md 9 years ago
Docker.md docker: Fix docker Makefile. 9 years ago
INSTALLGO.md build/vet: Fix all the shadowing reports with go1.6 9 years ago
LICENSE Initial commit 10 years ago
MAINTAINERS.md build: Add release builds, now generated with 'make release' 9 years ago
Makefile release: gz doesn't preserve permissions use tar.gz 9 years ago
NOTICE Fix typo 9 years ago
README.md docker: Fix docker command entry. 9 years ago
access-key.go config/main: Re-write config files - add to new config v3 9 years ago
accesslog-handler.go xl: Moved to minio/minio - fixes #1112 9 years ago
api-datatypes.go api: Implement multiple objects Delete api - fixes #956 9 years ago
api-errors.go error: Add proper prefixes for s3Error codes. 9 years ago
api-headers.go cleanup: Rename ObjectMetadata as ObjectInfo. 9 years ago
api-headers_test.go handlers: Cleanup time handlers helpers. 9 years ago
api-resources.go listObjects: Channel based changes. 9 years ago
api-response.go main: Remove all the dead/unused code. 9 years ago
api-router.go routers: Move API and Web routers into their own files. 9 years ago
appveyor.yml build/vet: Fix all the shadowing reports with go1.6 9 years ago
auth-handler.go signature: Use a layered approach for signature verification. 9 years ago
bucket-handlers.go signature: Use a layered approach for signature verification. 9 years ago
bucket-policy-handlers.go signature: Use a layered approach for signature verification. 9 years ago
bucket-policy-parser.go bucketpolicy: checkBucketPolicy should keep resources in map. 9 years ago
bucket-policy.go main: Remove all the dead/unused code. 9 years ago
build-constants.go build: Add release builds, now generated with 'make release' 9 years ago
certs.go config/main: Re-write config files - add to new config v3 9 years ago
commands.go minio: Server upon start displays a message if update is available. 9 years ago
config-migrate.go config/main: Re-write config files - add to new config v3 9 years ago
config-old.go config/main: Re-write config files - add to new config v3 9 years ago
config-v3.go config/main: set the missing value. 9 years ago
config.go config/main: Re-write config files - add to new config v3 9 years ago
damerau-levenshtein.go xl: Moved to minio/minio - fixes #1112 9 years ago
flags.go minio: Server upon start displays a message if update is available. 9 years ago
generic-handlers.go routers: Move API and Web routers into their own files. 9 years ago
globals.go minio: Server upon start displays a message if update is available. 9 years ago
httprange.go xl: Moved to minio/minio - fixes #1112 9 years ago
logger-console-hook.go config/main: Re-write config files - add to new config v3 9 years ago
logger-file-hook.go config/main: Re-write config files - add to new config v3 9 years ago
logger-syslog-hook_nix.go config/main: Re-write config files - add to new config v3 9 years ago
logger-syslog-hook_windows.go config/main: Re-write config files - add to new config v3 9 years ago
logger.go config/main: Re-write config files - add to new config v3 9 years ago
logger_test.go xl: Moved to minio/minio - fixes #1112 9 years ago
main.go minio: Server upon start displays a message if update is available. 9 years ago
main_test.go Migrate this project to minio micro services code 9 years ago
minio-main.go minio: Server upon start displays a message if update is available. 9 years ago
minio.md config/main: Re-write config files - add to new config v3 9 years ago
notifier.go minio: Server upon start displays a message if update is available. 9 years ago
object-handlers.go signature: Use a layered approach for signature verification. 9 years ago
routers.go UI: implement SetAuth/GenerateAuth handlers for changing credentials. 9 years ago
runtime-checks.go console: Fix console color printing on windows. 9 years ago
server_fs_test.go signature: Use a layered approach for signature verification. 9 years ago
signature-jwt.go signature: Use a layered approach for signature verification. 9 years ago
signature-v4-errors.go signature: Use a layered approach for signature verification. 9 years ago
signature-v4-parser.go signature: Use a layered approach for signature verification. 9 years ago
signature-v4-postpolicyform.go signature: Use a layered approach for signature verification. 9 years ago
signature-v4-utils.go signature: Use a layered approach for signature verification. 9 years ago
signature-v4.go signature: Use a layered approach for signature verification. 9 years ago
trie.go Add trie to verify wrong inputs, and provide meaningful messages 9 years ago
typed-errors.go signature: Use a layered approach for signature verification. 9 years ago
update-main.go release: gz doesn't preserve permissions use tar.gz 9 years ago
utils.go signature: Use a layered approach for signature verification. 9 years ago
version-main.go console: Fix console color printing on windows. 9 years ago
version_test.go Move all server and controller packages into top-level 9 years ago
web-handlers.go UI: implement SetAuth/GenerateAuth handlers for changing credentials. 9 years ago
web-router.go UI: implement SetAuth/GenerateAuth handlers for changing credentials. 9 years ago

README.md

Minio Gitter

Minio is an object storage server compatible with Amazon S3 and licensed under Apache license 2.0.

Description

Minio is an open source object storage server released under Apache License V2. It is compatible with Amazon S3 cloud storage service. Minio follows a minimalist design philosophy. Minio is light enough to be bundled with the application stack. It sits on the side of NodeJS, Redis, MySQL and the likes. Unlike databases, Minio stores objects such as photos, videos, log files, backups, container / VM images and so on. Minio is best suited for storing blobs of information ranging from KBs to TBs each. In a simplistic sense, it is like a FTP server with a simple get / put API over HTTP.

Minio currently implements two backends

  • Filesystem (FS) - is available and ready for general purpose use. This version of the Minio binary is built using Filesystem storage backend for magnetic and solid state disks.
  • ErasureCoded (XL) - is work in progress and not ready for general purpose use.

Minio Client

Minio Client (mc) provides a modern alternative to Unix commands like ls, cat, cp, sync, and diff. It supports POSIX compatible filesystems and Amazon S3 compatible cloud storage systems. It is entirely written in Golang.

Amazon S3 Compatible Client Libraries

Install Build StatusBuild status

GNU/Linux

Download minio for:

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

OS X

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

$ chmod 755 minio
$ ./minio --help

Microsoft Windows

Download minio for:

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

Docker container

Download minio for docker.

$ docker pull minio/minio

Read more here on How to configure data volume containers for Minio?

Source

NOTE: Source installation is intended for only developers and advanced users. For general use, please download official releases from https://minio.io/download.

If you do not have a working Golang environment, please follow Install Golang.

$ go get -d github.com/minio/minio
$ cd $GOPATH/src/github.com/minio/minio
$ make

How to use Minio?

Initialize minio server at ~/Photos

$ minio init fs ~/Photos

After successfully initializing, start minio server.

$ minio server

AccessKey: WLGDGYAQYIGI833EV05A  SecretKey: BYvgJM101sHngl2uzjXS/OBF/aMxAN06JrJ3qJlF  Region: us-east-1

Minio Object Storage:
    http://127.0.0.1:9000
    http://10.1.10.177:9000

Minio Browser:
    http://127.0.0.1:9000
    http://10.1.10.177:9000

To configure Minio Client:
    $ wget https://dl.minio.io/client/mc/release/darwin-amd64/mc
    $ chmod 755 mc
    $ ./mc config host add myminio http://localhost:9000 WLGDGYAQYIGI833EV05A BYvgJM101sHngl2uzjXS/OBF/aMxAN06JrJ3qJlF

How to use AWS CLI with Minio?

This section assumes that you have already installed aws-cli, if not please visit https://aws.amazon.com/cli/

To configure aws-cli, type aws configure and follow below steps.

$ aws configure
AWS Access Key ID [None]: YOUR_ACCESS_KEY_HERE
AWS Secret Access Key [None]: YOUR_SECRET_KEY_HERE
Default region name [None]: us-east-1
Default output format [None]: ENTER

Additionally enable aws-cli to use AWS Signature Version '4' for Minio server.

$ aws configure set default.s3.signature_version s3v4

To list your buckets.

$ aws --endpoint-url http://localhost:9000 s3 ls
2016-01-07 16:38:23 testbucket

To list contents inside bucket.

$ aws --endpoint-url http://localhost:9000 s3 ls s3://testbucket
                           PRE test/
2015-12-17 08:46:41   12232928 vim
2016-01-07 16:38:23   32232928 emacs
2015-12-09 08:05:24     138504 s3cmd

How to use AWS SDK with Minio?

Please follow the documentation here - Using aws-sdk-go with Minio server

How to use s3cmd with Minio?

This section assumes that you have already installed s3cmd, if not please visit http://s3tools.org/s3cmd

Edit the following fields in your s3cmd configuration file ~/.s3cfg .

host_base = localhost:9000
host_bucket = localhost:9000
access_key = YOUR_ACCESS_KEY_HERE
secret_key = YOUR_SECRET_KEY_HERE
signature_v2 = False

To make a bucket

$ s3cmd mb s3://mybucket
Bucket 's3://mybucket/' created

To copy an object to bucket

$ s3cmd put newfile.txt s3://testbucket
upload: 'newfile' -> 's3://testbucket/newfile'  

To copy an object to local system

$ s3cmd get s3://testbucket/newfile
download: 's3://testbucket/newfile' -> './newfile'

To sync local file/directory to a bucket

$ s3cmd sync newdemo s3://testbucket
upload: 'newdemo/newdemofile.txt' -> 's3://testbucket/newdemo/newdemofile.txt'

To sync bucket or object with local filesystem

$ s3cmd sync  s3://otherbucket otherlocalbucket
download: 's3://otherbucket/cat.jpg' -> 'otherlocalbucket/cat.jpg' 

To list buckets.

$ s3cmd ls s3://
2015-12-09 16:12  s3://testbbucket

To list contents inside bucket.

$ s3cmd ls s3://testbucket/
                       DIR   s3://testbucket/test/
2015-12-09 16:05    138504   s3://testbucket/newfile

Delete an object from bucket

$ s3cmd del s3://testbucket/newfile
delete: 's3://testbucket/newfile'

Delete a bucket

$ s3cmd rb s3://testbucket
Bucket 's3://testbucket/' removed

Contribute to Minio Project

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.