AltarDocker

Deploy your experiment data infrastructure locally by installing the basic bricks with Docker Compose. MongoDB stores small files, metadata and results and MinIO handles large raw data. Omniboard provides a web interface to visualize experiments, and AltarExtractor lets you filter and export datasets.

Quick start Install Source

Features

MongoDB

Store experiment metadata, configs, results, and metrics using Sacred's standard schema.

MinIO

S3-compatible object storage for large files like videos, images, and raw data.

Omniboard

Web dashboard to visualize Sacred experiments, view metrics, and download artifacts.

AltarExtractor

Browse, filter, and export experiments with advanced config filtering and CSV export.

Quick start

1

Start all services

docker compose --profile minio --profile extractor up -d

Launch MongoDB, MinIO, Omniboard, and AltarExtractor in detached mode. Will work only if you have previously followed the installation steps here.

2

Access the services

Open the URLs below to access each service. Default credentials are in the README.

Default URLs

MongoDB mongodb://localhost:27017
Omniboard http://localhost:9030
AltarExtractor http://localhost:8050
MinIO Console http://localhost:9001
MinIO S3 API http://localhost:9000

Related tools

AltarExtractor

Browse and filter Sacred experiments with a modern web UI.

Learn more →

AltarSender

Send experiments to Sacred and artifacts to MinIO.

Learn more →

AltarViewer

Desktop app to connect to your databases and open the interface to browse and visualize experiments.

Learn more →

Full Documentation

AltarDocker

Docker Compose stack for running Sacred ML experiment tracking infrastructure locally.

What’s Included

Service Description Port
MongoDB Stores experiment metadata 27017
Omniboard Web dashboard for Sacred experiments 9030
MinIO S3-compatible object storage (optional) 9000, 9001
AltarExtractor Browse and filter experiments (optional) 8050

Quick Start

  1. Create .env file with your credentials: 
    MONGO_DB=sacred

MINIO_ROOT_USER=minio_admin
MINIO_ROOT_PASSWORD=your_minio_password

OMNIBOARD_HOST_PORT=9030
EXTRACTOR_HOST_PORT=8050
MONGO_PORT=27017 # Careful here if you already have MongoDB installed on your computer, change this port to eg. 27077 !
  2. Start the stack: 
    # Basic (MongoDB + Omniboard)
docker compose up -d

# With MinIO
docker compose --profile minio up -d

# With AltarExtractor
docker compose --profile extractor up -d

# Full stack
docker compose --profile minio --profile extractor up -d
  3. Access the services:
    • Omniboard: http://localhost:9030
    • AltarExtractor: http://localhost:8050
    • MinIO Console: http://localhost:9001

Documentation

For developers:

Purpose: add credentials to MongoDB

Update the .env file:

   MONGO_ROOT_USER=admin
   MONGO_ROOT_PASSWORD=your_secure_password

and the “environment” section of docker-compose.yml file:

  mongo:
    image: mongo:6
    container_name: mongo
    restart: unless-stopped
    environment:
      MONGO_INITDB_ROOT_USERNAME: ${MONGO_ROOT_USER}
      MONGO_INITDB_ROOT_PASSWORD: ${MONGO_ROOT_PASSWORD}
      MONGO_INITDB_DATABASE: ${MONGO_DB}
    ports:
      - "${MONGO_PORT}:27017"
    volumes:
      - PATH/TO/DATA/mongo_data:/data/db

Requirements

  • Docker >= 24
  • Docker Compose v2
  • At least 2 GB free disk space
  • AltarExtractor — Browse and filter Sacred experiments in a web UI
  • AltarSender — GUI to send experiments to Sacred and MinIO

License

GNU General Public License v3.0