Skip to content

README.md

Latest commit

 

History

History
122 lines (90 loc) · 3.25 KB

README.md

File metadata and controls

122 lines (90 loc) · 3.25 KB

MinIO Docker Images

Automated builds of MinIO Docker images from official releases.

Since MinIO stopped providing pre-built Docker images for new releases, this repository automatically builds and publishes them to both GitHub Container Registry and Docker Hub.

If you need a specific version / release, open an issue. I (Andras) will make it available.

Available Images

Images are available at:

GitHub Container Registry (GHCR):

ghcr.io/coollabsio/minio:<tag>

Docker Hub:

docker.io/coollabsio/minio:<tag>
# or simply
coollabsio/minio:<tag>

Tags

  • latest - Latest MinIO release
  • RELEASE.2024-10-13T13-34-11Z - Specific release version (full release name)
  • 2024-10-13T13-34-11Z - Specific release version (without RELEASE. prefix)

Usage

Basic Usage

# Using Docker Hub (simpler, no authentication needed)
docker run -p 9000:9000 -p 9001:9001 \
  -e MINIO_ROOT_USER=minioadmin \
  -e MINIO_ROOT_PASSWORD=minioadmin \
  -v /path/to/data:/data \
  coollabsio/minio:latest \
  server /data --console-address ":9001"

# Or using GitHub Container Registry
docker run -p 9000:9000 -p 9001:9001 \
  -e MINIO_ROOT_USER=minioadmin \
  -e MINIO_ROOT_PASSWORD=minioadmin \
  -v /path/to/data:/data \
  ghcr.io/coollabsio/minio:latest \
  server /data --console-address ":9001"

Docker Compose

version: '3.8'

services:
  minio:
    image: coollabsio/minio:latest
    container_name: minio
    ports:
      - "9000:9000"
      - "9001:9001"
    environment:
      MINIO_ROOT_USER: minioadmin
      MINIO_ROOT_PASSWORD: minioadmin
    volumes:
      - minio-data:/data
    command: server /data --console-address ":9001"
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:9000/minio/health/live"]
      interval: 30s
      timeout: 20s
      retries: 3

volumes:
  minio-data:

Building Locally

To build an image locally:

# Build latest version
docker build -t minio:test .

# Build specific version
docker build --build-arg MINIO_VERSION=RELEASE.2024-10-13T13-34-11Z -t minio:test .

Architecture

  • Multi-platform: Built for both linux/amd64 and linux/arm64
  • Source-based: Compiled from official MinIO source code at each release
  • Minimal base: Uses Red Hat UBI9 micro image for security and size
  • Official scripts: Uses MinIO's official docker-entrypoint.sh and other scripts from the cloned repository

Ports

  • 9000: MinIO S3 API endpoint
  • 9001: MinIO Web Console (admin UI)

Environment Variables

  • MINIO_ROOT_USER: Root access key (username)
  • MINIO_ROOT_PASSWORD: Root secret key (password)
  • MINIO_CONFIG_ENV_FILE: Path to configuration file
  • See MinIO documentation for more options

License

This build automation is provided as-is. MinIO itself is licensed under AGPL-3.0.

Note: According to MinIO's license terms, production use of compiled-from-source binaries is at your own risk. For production deployments, MinIO recommends their enterprise offerings.

Links