MinIO + Admin Console Docker Image

Background

In June 2025, MinIO removed most web UI management features from the Community Edition and reserved them for paid AIStor, pushing OSS users toward CLI-only workflows. In October 2025, MinIO stopped publishing Community Edition binaries and Docker images, requiring builds from source. These moves followed MinIO’s 2021 shift to AGPLv3 and stricter license enforcement aimed at curbing commercial “free riding.”

This image restores a full admin UI and offers a ready-to-run container while remaining transparent about AGPL obligations.

License Notice: MinIO uses AGPLv3. Commercial use requires either open-sourcing your codebase or purchasing a license starting at $96,000/year.

Recent Commits

Features

Latest MinIO Server

Built from source with S3-compatible API for seamless integration.

Full Admin Console

Complete web UI on port 9002 with all management features.

MinIO Client

Command-line tools cryptographically verified with minisign.

Multi-Architecture

Native support for AMD64 and ARM64 processors.

Security Hardened

Non-root user, health checks, auto-generated secrets.

Single Container

Everything bundled: API (9000), console (9001), admin UI (9002).

Use Cases

S3-Compatible Storage

Use as a drop-in replacement for AWS S3 with standard APIs.

Media Management

Store and deliver images, videos, and large assets efficiently.

Backup & Archive

Durable, cost‑effective storage for backups and long‑term retention.

AI & ML

High‑throughput storage for training data and model artifacts.

Data Lakes

Build lakehouse pipelines; pair with Apache Iceberg tables.

Self‑Hosted Cloud

Own your data, run privately, avoid vendor lock‑in.

Installation

Architecture Selection

Docker Run

docker run -d --name minio \
  -p 9000:9000 \
  -p 9001:9001 \
  -p 9002:9002 \
  -v ./data:/data \
  -e MINIO_ROOT_USER=UL5YXh4vjy3yEAaS4eW8 \
  -e MINIO_ROOT_PASSWORD=36bpUPfiptWp6M7uBFsM75uKbPXZgW \
  firstfinger/minio:latest-amd64

Docker Compose

For ARM64, create a .env file with: MINIO_IMAGE_TAG=latest-arm64

docker compose up -d

Access Points

Service	URL	Purpose
MinIO API	`http://localhost:9000`	S3-compatible API
MinIO Console	`http://localhost:9001`	Basic built-in UI
Admin Console	`http://localhost:9002`	Full-featured admin UI

Configuration

Essential Environment Variables

Variable	Description	Example
`MINIO_ROOT_USER`	Root username	`admin`
`MINIO_ROOT_PASSWORD`	Root password	`SecurePass123!`
`MINIO_REGION`	AWS S3 region	`us-east-1`

Port Configuration

Variable	Default	Description
`MINIO_API_PORT`	`9000`	MinIO API port
`MINIO_CONSOLE_PORT`	`9001`	MinIO console port
`MINIO_ADMIN_CONSOLE_PORT`	`9002`	Admin console port

Using MinIO Client

The MinIO client (mc) is included for command-line operations:

Configure

docker exec minio mc alias set local http://localhost:9000 admin your-password

Create Bucket

docker exec minio mc mb local/mybucket

Upload File

docker exec minio mc cp /path/to/file local/mybucket/

Security Notes

Non-Root User: Runs as UID 1000 for security
Permissions: Set data directory ownership: sudo chown -R 1000:1000 ./data
Credentials: Change default credentials in production
TLS Certificates: Mount to /data/.minio/certs/ for HTTPS
Auto-Generated Secrets: Console secrets created automatically if not provided
Binary Verification: MC client verified with minisign cryptographic signatures

Troubleshooting

Permission Denied

If you see permission errors, set proper ownership:

sudo chown -R 1000:1000 ./data

Port Conflicts

Use custom ports if defaults are taken:

-e MINIO_API_PORT=8000 -e MINIO_CONSOLE_PORT=8001 -e MINIO_ADMIN_CONSOLE_PORT=8002

Service Not Starting

Check container logs:

docker logs minio

Region Errors

Ensure region is set (defaults to us-east-1):

-e MINIO_REGION=us-east-1