2019-04-09 20:39:42 +02:00
# MinIO Azure Gateway [![Slack](https://slack.min.io/slack?type=svg)](https://slack.min.io)
MinIO Gateway adds Amazon S3 compatibility to Microsoft Azure Blob Storage.
2017-07-10 18:35:20 +02:00
2019-04-09 20:39:42 +02:00
## Run MinIO Gateway for Microsoft Azure Blob Storage
2017-07-10 18:35:20 +02:00
### Using Docker
```
docker run -p 9000:9000 --name azure-s3 \
2017-10-23 11:08:38 +02:00
-e "MINIO_ACCESS_KEY=azurestorageaccountname" \
-e "MINIO_SECRET_KEY=azurestorageaccountkey" \
2020-04-23 11:04:13 +02:00
-e "MINIO_AZURE_CHUNK_SIZE_MB=0.25" \
2017-07-10 18:35:20 +02:00
minio/minio gateway azure
```
### Using Binary
```
export MINIO_ACCESS_KEY=azureaccountname
export MINIO_SECRET_KEY=azureaccountkey
2020-04-23 11:04:13 +02:00
export MINIO_AZURE_CHUNK_SIZE_MB=0.25
2017-07-10 18:35:20 +02:00
minio gateway azure
```
2019-04-09 20:39:42 +02:00
## Test using MinIO Browser
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.
2017-07-10 18:35:20 +02:00
![Screenshot ](https://github.com/minio/minio/blob/master/docs/screenshots/minio-browser-gateway.png?raw=true )
2019-04-09 20:39:42 +02:00
## Test using MinIO Client `mc`
2017-07-10 18:35:20 +02: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`
```
2020-08-18 02:39:55 +02:00
mc alias set myazure http://gateway-ip:9000 azureaccountname azureaccountkey
2017-07-10 18:35:20 +02:00
```
### List containers on Microsoft Azure
```
mc ls myazure
[2017-02-22 01:50:43 PST] 0B ferenginar/
[2017-02-26 21:43:51 PST] 0B my-container/
[2017-02-26 22:10:11 PST] 0B test-container1/
```
### Known limitations
2017-10-17 04:42:44 +02:00
Gateway inherits the following Azure limitations:
- Only read-only bucket policy supported at bucket level, all other variations will return API Notimplemented error.
- Bucket names with "." in the bucket name are not supported.
- Non-empty buckets get removed on a DeleteBucket() call.
2018-09-07 02:19:51 +02:00
- _List Multipart Uploads_ always returns empty list.
2017-10-17 04:42:44 +02:00
Other limitations:
- Bucket notification APIs are not supported.
2017-07-10 18:35:20 +02:00
## Explore Further
2019-04-09 20:39:42 +02:00
- [`mc` command-line interface ](https://docs.min.io/docs/minio-client-quickstart-guide )
- [`aws` command-line interface ](https://docs.min.io/docs/aws-cli-with-minio )
- [`minio-go` Go SDK ](https://docs.min.io/docs/golang-client-quickstart-guide )