minio/docs/docker

Minio Docker Quickstart Guide

1. Prerequisites

GNU/Linux

Install Docker for GNU/Linux from here

Microsoft Windows

Install Docker for Windows from here

macOS

Install Docker for macOS from here

2. Test Minio on Docker.

Minio generates new access and secret keys each time you run this command. Container state is lost after you end this session. This mode is only intended for testing purpose.

docker run -p 9000:9000 minio/minio server /export

3. Run Minio Standalone on Docker.

Minio container requires a persistent volume to store configuration and application data. Following command maps local persistent directories from the host OS to virtual config ~/.minio and export /export directories.

GNU/Linux and macOS

docker run -p 9000:9000 --name minio1 \
  -v /mnt/export/minio1:/export \
  -v /mnt/config/minio1:/root/.minio \
  minio/minio server /export

Microsoft Windows

docker run -p 9000:9000 --name minio1 \
  -v D:\export\minio1:/export \
  -v D:\export\minio1-config:/root/.minio \
  minio/minio server /export

4. Run Minio Standalone on Docker with Custom Access and Secret Keys

To override Minio's auto-generated keys, you may pass secret and access keys explicitly as environment variables. Minio server also allows regular strings as access and secret keys.

GNU/Linux and macOS

docker run -p 9000:9000 --name minio1 \
  -e "MINIO_ACCESS_KEY=AKIAIOSFODNN7EXAMPLE" \
  -e "MINIO_SECRET_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY" \
  -v /mnt/export/minio1:/export \
  -v /mnt/config/minio1:/root/.minio \
  minio/minio server /export

Microsoft Windows

docker run -p 9000:9000 --name minio1 \
  -e "MINIO_ACCESS_KEY=AKIAIOSFODNN7EXAMPLE" \
  -e "MINIO_SECRET_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY" \
  -v D:\export\minio1:/export \
  -v D:\export\minio1-config:/root/.minio \
  minio/minio server /export

5. Test Distributed Minio on Docker

This example shows how to run 4 node Minio cluster inside different docker containers using docker-compose. Please download docker-compose.yml to your current working directory, docker-compose pulls the Minio Docker image.

Run docker-compose on GNU/Linux and macOS

docker-compose pull
docker-compose up

Run docker-compose.exe on Microsoft Windows

docker-compose.exe pull
docker-compose.exe up

Each instance is accessible on the host at ports 9001 through 9004, proceed to access the Web browser at http://127.0.0.1:9001/

6. Explore Further

• Minio Erasure Code QuickStart Guide
• Distributed Minio Quickstart Guide
• Docker Compose