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
2015-10-16 20:40:47 +02:00
Minio is a minimal cloud storage server for Micro Services. Written in Golang and licensed under [Apache license v2 ](./LICENSE ). Compatible with Amazon S3 APIs.
## Description
Micro services environment provisions one Minio server per application instance. Scalability is achieved to 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
#### Linux, OS X, Windows
2015-07-14 19:57:53 +02:00
2015-05-28 03:34:42 +02:00
~~~
2015-10-16 20:26:01 +02:00
$ go get github.com/minio/minio
2015-05-28 03:34:42 +02:00
~~~
2015-10-16 20:26:01 +02:00
### How to use Minio?
2015-09-18 00:16:28 +02:00
2015-10-16 20:26:01 +02:00
~~~
$ minio server
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:
minio server PATH
2015-06-17 01:03:17 +02:00
2015-10-16 20:26:01 +02:00
EXAMPLES:
1. Start minio server on Linux.
$ 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.
$ 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.
$ minio --address 192.168.1.101:9000 /home/shared
2015-06-17 01:03:17 +02:00
~~~
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
AccessKey: G5GJRH51R2HSUWYPGIX5 SecretKey: uxhBC1Yscut3/u81l5L8Yp636ZUk32N4m/gFASuZ
2015-09-18 00:16:28 +02:00
2015-10-16 20:26:01 +02:00
To configure Minio Client.
2015-06-17 01:09:10 +02:00
2015-10-16 20:26:01 +02:00
$ wget https://dl.minio.io:9000/updates/2015/Oct/darwin-amd64/mc
$ chmod 755 mc
$ ./mc config host add localhost:9000 G5GJRH51R2HSUWYPGIX5 uxhBC1Yscut3/u81l5L8Yp636ZUk32N4m/gFASuZ
$ ./mc mb localhost/photobucket
$ ./mc cp ~/Photos... localhost/photobucket
2015-06-17 01:09:10 +02:00
2015-10-16 20:26:01 +02:00
Starting minio server:
Listening on http://127.0.0.1:9000
Listening on http://172.30.2.17:9000
2015-06-17 01:03:17 +02:00
~~~
2015-06-17 01:09:10 +02:00
2015-09-27 00:29:05 +02: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