2018-02-20 21:21:12 +01:00
# Minio NAS Gateway [![Slack](https://slack.minio.io/slack?type=svg)](https://slack.minio.io)
2018-12-18 23:37:17 +01:00
2018-02-20 21:21:12 +01:00
Minio Gateway adds Amazon S3 compatibility to NAS storage. You may run multiple minio instances on the same shared NAS volume as a distributed object gateway.
## Run Minio Gateway for NAS Storage
2018-12-18 23:37:17 +01:00
2018-02-20 21:21:12 +01:00
### Using Docker
2018-12-18 23:37:17 +01:00
Please ensure to replace `/shared/nasvol` with actual mount path.
2018-02-20 21:21:12 +01:00
```
docker run -p 9000:9000 --name nas-s3 \
-e "MINIO_ACCESS_KEY=minio" \
-e "MINIO_SECRET_KEY=minio123" \
2018-12-18 23:37:17 +01:00
-v /shared/nasvol:/container/vol \
minio/minio gateway nas /container/vol
2018-02-20 21:21:12 +01:00
```
### Using Binary
2018-12-18 23:37:17 +01:00
2018-02-20 21:21:12 +01:00
```
2018-12-18 23:37:17 +01:00
export MINIO_ACCESS_KEY=minio
export MINIO_SECRET_KEY=minio123
2018-02-20 21:21:12 +01:00
minio gateway nas /shared/nasvol
```
2018-12-18 23:37:17 +01:00
2018-02-20 21:21:12 +01:00
## Test using Minio Browser
2018-12-18 23:37:17 +01:00
2018-02-20 21:21:12 +01:00
Minio Gateway comes with an embedded web based object browser. Point your web browser to http://127.0.0.1:9000 to ensure that your server has started successfully.
![Screenshot ](https://raw.githubusercontent.com/minio/minio/master/docs/screenshots/minio-browser-gateway.png )
## Test using Minio Client `mc`
2018-12-18 23:37:17 +01:00
2018-02-20 21:21:12 +01:00
`mc` provides a modern alternative to UNIX commands such as ls, cat, cp, mirror, diff etc. It supports filesystems and Amazon S3 compatible cloud storage services.
### Configure `mc`
2018-12-18 23:37:17 +01:00
2018-02-20 21:21:12 +01:00
```
mc config host add mynas http://gateway-ip:9000 access_key secret_key
```
### List buckets on nas
2018-12-18 23:37:17 +01:00
2018-02-20 21:21:12 +01:00
```
mc ls mynas
[2017-02-22 01:50:43 PST] 0B ferenginar/
[2017-02-26 21:43:51 PST] 0B my-bucket/
[2017-02-26 22:10:11 PST] 0B test-bucket1/
```
## Explore Further
- [`mc` command-line interface ](https://docs.minio.io/docs/minio-client-quickstart-guide )
- [`aws` command-line interface ](https://docs.minio.io/docs/aws-cli-with-minio )
- [`minio-go` Go SDK ](https://docs.minio.io/docs/golang-client-quickstart-guide )