2015-10-16 20:26:01 +02:00
## Minio [![Gitter](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/minio/minio?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
2015-05-28 03:34:42 +02:00
2016-01-30 03:09:34 +01:00
Minio is a distributed object storage server written in Golang. Source is available under free software / open source [Apache license 2.0 ](./LICENSE ). API compatible with Amazon S3 cloud storage service.
2015-10-16 20:40:47 +02:00
## Description
2015-12-02 20:28:41 +01:00
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.
2015-05-28 03:34:42 +02:00
2015-07-14 20:58:37 +02:00
## Minio Client
2015-07-14 19:57:53 +02:00
2015-07-25 03:09:53 +02:00
[Minio Client (mc) ](https://github.com/minio/mc#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.
2015-07-14 19:57:53 +02:00
## Amazon S3 Compatible Client Libraries
- [Golang Library ](https://github.com/minio/minio-go )
- [Java Library ](https://github.com/minio/minio-java )
- [Nodejs Library ](https://github.com/minio/minio-js )
- [Python Library ](https://github.com/minio/minio-py )
2015-10-16 20:26:01 +02:00
- [.Net Library ](https://github.com/minio/minio-dotnet )
2015-10-16 20:56:53 +02:00
### Install [![Build Status](https://travis-ci.org/minio/minio.svg?branch=master)](https://travis-ci.org/minio/minio)[![Build status](https://ci.appveyor.com/api/projects/status/royh137dni8yevep/branch/master?svg=true)](https://ci.appveyor.com/project/harshavardhana/minio-qxbjq/branch/master)
2015-10-16 20:26:01 +02:00
2015-11-14 11:39:02 +01:00
#### GNU/Linux
Download ``minio`` for:
2015-12-13 22:57:47 +01:00
- ``64-bit Intel`` from https://dl.minio.io/server/minio/release/linux-amd64/minio
- ``32-bit Intel`` from https://dl.minio.io/server/minio/release/linux-386/minio
- ``32-bit ARM`` from https://dl.minio.io/server/minio/release/linux-arm/minio
2015-07-14 19:57:53 +02:00
2015-05-28 03:34:42 +02:00
~~~
2015-11-14 11:39:02 +01:00
$ chmod +x minio
2016-01-08 19:17:08 +01:00
$ ./minio --help
2015-11-14 11:39:02 +01:00
~~~
#### OS X
2015-12-13 22:57:47 +01:00
Download ``minio`` from https://dl.minio.io/server/minio/release/darwin-amd64/minio
2015-11-14 11:39:02 +01:00
~~~
$ chmod 755 minio
2016-01-08 19:17:08 +01:00
$ ./minio --help
2015-05-28 03:34:42 +02:00
~~~
2015-11-14 11:39:02 +01:00
#### Microsoft Windows
Download ``minio`` for:
2015-12-13 22:57:47 +01:00
- ``64-bit`` from https://dl.minio.io/server/minio/release/windows-amd64/minio.exe
- ``32-bit`` from https://dl.minio.io/server/minio/release/windows-386/minio.exe
2015-11-14 11:39:02 +01:00
~~~
2016-01-08 19:17:08 +01:00
C:\Users\Username\Downloads> minio.exe --help
2015-11-14 11:39:02 +01:00
~~~
2016-01-13 18:40:20 +01:00
#### Docker container
2015-12-05 01:26:09 +01:00
2016-01-13 18:40:20 +01:00
Download ``minio`` for docker.
2015-12-05 01:26:09 +01:00
~~~
$ docker pull minio/minio
~~~
Read more here on [How to configure data volume containers for Minio? ](./Docker.md )
2015-11-14 11:39:02 +01:00
#### Source
< blockquote >
2016-01-31 12:48:33 +01:00
NOTE: Source installation is intended for only developers and advanced users. For general use, please download official releases from https://minio.io/download.
2015-11-14 11:39:02 +01:00
< / blockquote >
If you do not have a working Golang environment, please follow [Install Golang ](./INSTALLGO.md ).
2016-01-31 12:48:33 +01:00
~~~
$ go get -d github.com/minio/minio
$ cd $GOPATH/src/github.com/minio/minio
$ make
~~~
2015-11-14 11:39:02 +01:00
2015-10-16 20:26:01 +02:00
### How to use Minio?
2015-09-18 00:16:28 +02:00
2015-10-22 10:31:09 +02:00
```
2015-10-16 20:26:01 +02:00
NAME:
minio server - Start Minio cloud storage server.
2015-09-18 00:16:28 +02:00
2015-10-16 20:26:01 +02:00
USAGE:
2015-10-22 10:31:09 +02:00
minio server [OPTION VALUE] PATH
OPTION = expiry VALUE = NN[h|m|s] [DEFAULT=Unlimited]
OPTION = min-free-disk VALUE = NN% [DEFAULT: 10%]
2015-06-17 01:03:17 +02:00
2015-10-16 20:26:01 +02:00
EXAMPLES:
1. Start minio server on Linux.
2015-10-20 08:03:01 +02:00
$ minio server /home/shared
2015-06-17 01:09:10 +02:00
2015-10-16 20:26:01 +02:00
2. Start minio server on Windows.
2015-10-20 08:03:01 +02:00
$ minio server C:\MyShare
2015-06-17 01:09:10 +02:00
2015-10-16 20:26:01 +02:00
3. Start minio server bound to a specific IP:PORT, when you have multiple network interfaces.
2015-10-20 08:03:01 +02:00
$ 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
2015-10-22 10:31:09 +02:00
```
#### Start Minio server.
2015-10-16 20:26:01 +02:00
2015-06-17 01:03:17 +02:00
~~~
2015-10-16 20:26:01 +02:00
$ minio server ~/Photos
2016-01-31 12:48:33 +01:00
AccessKey: WLGDGYAQYIGI833EV05A SecretKey: BYvgJM101sHngl2uzjXS/OBF/aMxAN06JrJ3qJlF Region: us-east-1
2015-09-18 00:16:28 +02:00
2016-01-31 12:48:33 +01:00
Minio Object Storage:
http://127.0.0.1:9000
http://10.0.0.3:9000
2015-06-17 01:09:10 +02:00
2016-01-31 12:48:33 +01:00
Minio Browser:
http://127.0.0.1:9000
http://10.0.0.3:9000
2015-06-17 01:09:10 +02:00
2016-01-31 12:48:33 +01:00
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
2015-06-17 01:03:17 +02:00
~~~
2015-06-17 01:09:10 +02:00
2016-01-09 04:42:45 +01:00
#### How to use AWS CLI with Minio?
< blockquote >
This section assumes that you have already installed aws-cli, if not please visit https://aws.amazon.com/cli/
< / blockquote >
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.
```
2016-01-26 22:55:12 +01:00
$ aws --endpoint-url http://localhost:9000 s3 ls s3://testbucket
2016-01-09 04:42:45 +01:00
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
```
2015-10-22 10:31:09 +02:00
#### How to use AWS SDK with Minio?
Please follow the documentation here - [Using aws-sdk-go with Minio server ](./AWS-SDK-GO.md )
2015-12-06 22:40:48 +01:00
#### How to use s3cmd with Minio?
2016-01-09 04:42:45 +01:00
< blockquote >
This section assumes that you have already installed s3cmd, if not please visit http://s3tools.org/s3cmd
< / blockquote >
Edit the following fields in your s3cmd configuration file `~/.s3cfg` .
2015-12-10 00:38:40 +01:00
```
host_base = localhost:9000
host_bucket = localhost:9000
access_key = YOUR_ACCESS_KEY_HERE
secret_key = YOUR_SECRET_KEY_HERE
```
To list your buckets.
```
2015-12-29 02:43:28 +01:00
$ s3cmd ls s3://
2015-12-10 00:38:40 +01:00
2015-12-09 16:12 s3://testbbucket
```
To list contents inside buckets.
```
2015-12-29 02:43:28 +01:00
$ s3cmd ls s3://testbucket/
2015-12-10 00:38:40 +01:00
DIR s3://testbucket/test/
2015-12-09 16:05 138504 s3://testbucket/newfile
```
2015-12-06 22:40:48 +01:00
2015-11-07 03:58:28 +01:00
## Contribute to Minio Project
2015-09-27 00:34:28 +02:00
Please follow Minio [Contributor's Guide ](./CONTRIBUTING.md )
2015-09-27 00:29:05 +02:00
2015-11-07 03:58:28 +01:00
### 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.