Docker Compose

The fastest way to get a working compose file is the Compose Generator — it fills in your paths, generates a secret key, and lets you download the file directly.

Minimal setup

services:
  grimoire:
    image: hunterreadca/grimoire:latest
    container_name: grimoire
    restart: unless-stopped
    ports:
      - "9481:9481"
    environment:
      - LIBRARY_PATH=/library
      - DATA_PATH=/data
      - WORKERS=2
      - SECRET_KEY=change-me   # openssl rand -hex 32
    volumes:
      - /path/to/your/library:/library:ro
      - /path/to/grimoire/data:/data

With Valkey cache

Recommended for large libraries or multi-user setups. Keeps rendered PDF page images in memory for faster repeat loads.

services:
  grimoire:
    image: hunterreadca/grimoire:latest
    container_name: grimoire
    restart: unless-stopped
    ports:
      - "9481:9481"
    environment:
      - LIBRARY_PATH=/library
      - DATA_PATH=/data
      - WORKERS=2
      - SECRET_KEY=change-me
      - VALKEY_URL=redis://valkey:6379/0
    volumes:
      - /path/to/your/library:/library:ro
      - /path/to/grimoire/data:/data
    depends_on:
      - valkey
    networks:
      - grimoire

  valkey:
    image: valkey/valkey:8-alpine
    container_name: grimoire-valkey
    restart: unless-stopped
    volumes:
      - valkey_data:/data
    networks:
      - grimoire

volumes:
  valkey_data:

networks:
  grimoire:

Build from source

docker build --build-arg APP_VERSION=1.0.0 -t grimoire:1.0.0 .
docker compose up -d

Updating

docker compose pull
docker compose up -d

Your data volume is unaffected by updates.

Pre-made example files

Ready-to-copy compose files are in the grimoire repository:

File	What it includes
docker-compose.yml	Grimoire only (minimal)
docker-compose.valkey.yml	+ Valkey page cache
docker-compose.filebrowser.yml	+ Filebrowser Quantum
docker-compose.calibre.yml	+ Calibre full desktop
docker-compose.calibre-web.yml	+ Calibre-Web