MinIo ALStor

Prerequisites

License

MinIO AIStor requires a license to run.
To request a free tier license, go to the MinIO AIStor pricing page and select Get Started under the Free tier.
Save the license to minio.license inside .docker/minio directory.

Tools

Before installing the project, make sure the following tools are available on your machine:

• Docker Engine installed and running
• Docker Compose plugin available
• Makefile installed
• An existing Docker Traefik network, since the project relies on an external network named traefik-network

Quick check:

docker --version
docker compose version
make --version

ENV

In the .env file, put the right trafik network name in TRAEFIK_NETWORK

TRAEFIK_NETWORK=traefik-network

Configuration

The project uses a local .env file to define the MinIO instance settings and the hosts exposed through Traefik.

Example configuration included in the repository:

PROJECT_NAME=minio
CONSOLE_HOST=minio.localhost
API_URL=minio-api.localhost
TRAEFIK_NETWORK=traefik-network

Update these values as needed for your local environment or Traefik domain.

Installation

1. Clone the repository:

git clone <repo-url>
cd minio-docker

2. Check the configuration:

make config

3. Start the stack with Docker Compose:

docker compose up -d

Or using the Makefile:

make up

The make up command automatically runs the initialization and build steps before starting the containers:

make up

Available services

Once the containers are running, the MinIO interface is available at:

• Console: https://minio.localhost
• S3 API: https://minio-api.localhost

Default credentials:

• Username: minioadmin
• Password: minioadmin

Management

Useful commands:

make logs
make ps
make shell

• make logs shows container logs
• make ps lists running containers
• make shell opens a shell inside the MinIO container

Notes

• The MinIO service is exposed through Traefik on the external network traefik-network.
• The project expects a Traefik infrastructure to already be in place for TLS certificate management and routing.