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 4ef01bc225 Merge pull request #1109 from krishnasrinivas/getuiversion 9 years ago
buildscripts build: Add build dependency check for 'gpg' 9 years ago
pkg pkg/user: Support 32bit darwin in user package. 9 years ago
vendor getObject: Add support for special response headers. 9 years ago
.gitignore ui-assets: Integrate UI assets. 9 years ago
.mailmap Update AB's duplicate email address 9 years ago
.travis.yml build: Handle builds on env where CGO_ENABLED=0 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
CONTRIBUTING.md Migrate this project to minio micro services code 9 years ago
Docker.md docker: Fix docker build. 9 years ago
Dockerfile docker: Fix docker build. 9 years ago
INSTALLGO.md Modifed instructions for installing Go. 9 years ago
LICENSE Initial commit 10 years ago
MAINTAINERS.md doc: Add MAINTAINERS.md 9 years ago
Makefile build: Cleanup assets file upon make clean. 9 years ago
NOTICE Move from Minimalist Object Storage to Minio Cloud Storage 10 years ago
README.md Add doc change. 9 years ago
accesslog-handler.go handlers: Fix the naming of all handlers. 9 years ago
api-auth-utils.go fs: Cleanup Golang errors to be called 'e' and probe to be called as 'err' 9 years ago
api-definitions.go bucket-location: Implement bucket location response. 9 years ago
api-errors.go fs: Fail createObject with appropriate message. 9 years ago
api-headers.go multipart: Code cleanup 9 years ago
api-resources.go listObjects: Channel based changes. 9 years ago
api-response.go multipart: Code cleanup 9 years ago
api-signature.go fs: Cleanup Golang errors to be called 'e' and probe to be called as 'err' 9 years ago
appveyor.yml ui-assets: Integrate UI assets. 9 years ago
bucket-acl.go Migrate this project to minio micro services code 9 years ago
bucket-handlers.go multipart: Code cleanup 9 years ago
build-constants.go build: Versioning now populated through ldflags 9 years ago
commands.go Add trie to verify wrong inputs, and provide meaningful messages 9 years ago
config-logger-main.go minio: Add config-folder option. 9 years ago
config-main.go Add logger command - also migrate from old config to newer config 9 years ago
config-version-main.go minio: Add config-folder option. 9 years ago
console.go Migrate this project to minio micro services code 9 years ago
flags.go flags: Remove anonymous, ratelimit, json and web-address flags. 9 years ago
generic-handlers.go handlers: Fix the naming of all handlers. 9 years ago
httprange.go Implement Bucket ACL support 9 years ago
jwt-auth-handler.go handlers: Fix the naming of all handlers. 9 years ago
jwt.go jwt: Trim username and password strings 9 years ago
logger-file-hook.go logger: Improve logger input argument handling and colorize outputs 9 years ago
logger-mongo-hook.go Add new logging connectors 9 years ago
logger-syslog-hook_nix.go Rename _linux to _nix for OS X build 9 years ago
logger-syslog-hook_windows.go Enable all config loggers 9 years ago
logger.go Migrate this project to minio micro services code 9 years ago
logger_test.go Migrate this project to minio micro services code 9 years ago
main.go fs: Cleanup Golang errors to be called 'e' and probe to be called as 'err' 9 years ago
main_test.go Migrate this project to minio micro services code 9 years ago
notifier.go update: Re-write update command. 9 years ago
object-handlers.go getObject: Add support for special response headers. 9 years ago
release.cmd release: Add release scripts. 9 years ago
release.sh doc: Add MAINTAINERS.md 9 years ago
routers.go server: Remove max-buckets option and now max buckets is unlimited. 9 years ago
server-config.go listObjects: Channel based changes. 9 years ago
server-main.go server: Remove max-buckets option and now max buckets is unlimited. 9 years ago
server_fs_test.go multipart: Multipart session map now is based on uploadID. 9 years ago
signature-handler.go handlers: Fix the naming of all handlers. 9 years ago
signature_utils_test.go Migrate this project to minio micro services code 9 years ago
trie.go Add trie to verify wrong inputs, and provide meaningful messages 9 years ago
typed-errors.go Bring in the list APIs implemented by Bala <bala@minio.io> 9 years ago
update-main.go update: Minio fix update url. 9 years ago
utils.go fix: handle Transfer-Encoding for make bucket 9 years ago
verify-runtime.go Implement update command 9 years ago
version-main.go docker: second --ldflags was overriding the first --ldflags option 9 years ago
version_test.go Move all server and controller packages into top-level 9 years ago
web-definitions.go webrpc: Implement GetUIVersion json-rpc API. 9 years ago
web-handlers.go webrpc: Implement GetUIVersion json-rpc API. 9 years ago

README.md

Minio Gitter

Minio is a distributed object storage server written in Golang. Source is available under free software / open source Apache license 2.0. API compatible with Amazon S3 cloud storage service.

Description

Micro services environment provisions one Minio server per application instance. Scalability is achieved through large number of smaller personalized instances. This version of the Minio binary is built using Filesystem storage backend for magnetic and solid state disks.

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?

NAME:
  minio server - Start Minio cloud storage server.

USAGE:
  minio server [OPTION VALUE] PATH

  OPTION = expiry        VALUE = NN[h|m|s] [DEFAULT=Unlimited]
  OPTION = min-free-disk VALUE = NN% [DEFAULT: 10%]

EXAMPLES:
  1. Start minio server on Linux.
        $ minio server /home/shared

  2. Start minio server on Windows.
        $ minio server C:\MyShare

  3. Start minio server bound to a specific IP:PORT, when you have multiple network interfaces.
        $ minio --address 192.168.1.101:9000 server /home/shared

  4. Start minio server with minimum free disk threshold to 5%
        $ minio server min-free-disk 5% /home/shared/Pictures

  5. Start minio server with minimum free disk threshold to 15% with auto expiration set to 1h
        $ minio server min-free-disk 15% expiry 1h /home/shared/Documents

Start Minio server.

$ minio server ~/Photos
AccessKey: WLGDGYAQYIGI833EV05A  SecretKey: BYvgJM101sHngl2uzjXS/OBF/aMxAN06JrJ3qJlF  Region: us-east-1

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

Minio Browser:
    http://127.0.0.1:9000
    http://10.0.0.3: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

To list your buckets.

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

To list contents inside buckets.

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

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.