Skip to content

Docker

Docker is the standard way to run Reclaimerr outside of development.

Example Compose

services:
  reclaimerr:
    image: ghcr.io/jessielw/reclaimerr:latest
    container_name: reclaimerr
    restart: unless-stopped
    env_file: .env
    volumes:
      - ./data:/app/data
      - /media:/media
    ports:
      - "8000:8000"

Common Environment Variables

DATA_DIR=./data
API_HOST=0.0.0.0
API_PORT=8000
TZ=America/New_York
UMASK=022
PROXY_TRUSTED_HOSTS=127.0.0.1,::1

Volume Guidance

  • Mount the same library paths that your media server uses.
  • Mount any destination path used for move-based cleanup.
  • Keep the data directory persistent so the database and logs survive restarts.

When You Are Behind A Proxy

If the API sits behind SWAG or another reverse proxy, make sure forwarded headers are preserved and PROXY_TRUSTED_HOSTS points at the proxy IP or CIDR. Set Application URL in General Settings if you want Plex and OIDC callbacks to use a fixed public base URL.

See the production guide for the hardening checklist.