Skip to content

Installation Unraid

chodeus edited this page May 22, 2026 · 4 revisions

Installation — Unraid

I publish an Unraid Docker template alongside the source. Two ways to install:

Option A — Use the template (easiest)

  1. In Unraid: Docker → Add Container
  2. Paste this into the Template URL field:
    https://raw.githubusercontent.com/chodeus/chub/main/deploy/unraid/chub.xml
    
  3. Adjust the paths, port, and TZ to match your setup, then Apply.

The template ships with Unraid-correct defaults: PUID=99, PGID=100, UMASK=002, paths under /mnt/user/appdata/chub and /mnt/user/data. Once Unraid pulls the image and starts the container, open http://:8000 and follow First Run.

Option B — Manual Docker → Add Container

If you'd rather fill the form by hand:

Field Value
Name chub
Repository ghcr.io/chodeus/chub:latest
Network Type bridge
Port 8000:8000 (host:container)

Paths

Container Host
/config /mnt/user/appdata/chub/
/media /mnt/user/data/media/
/data /mnt/user/data/ (for cross-volume nohl/jduparr walks)
/kometa your Kometa asset folder
/plex Plex's Library/Application Support/Plex Media Server/ (only needed for poster_cleanarr)

Variables

Variable Value
PUID 99
PGID 100
UMASK 002
TZ your timezone

Once the container is running, open http://:8000 and follow First Run.


Tips for Unraid

  • Use the 6.12+ Docker tab if you want the nice Edit → Apply flow; CHUB doesn't need a custom template.
  • Auto-start under Advanced view if you want CHUB to come up with the array.
  • Folder ownership: Unraid writes as 99:100; CHUB runs as the same pair by default, so the appdata folder is writable out of the box.
  • Pinning: a date-style tag (ghcr.io/chodeus/chub:2026.04.20) is more stable than :latest if you care about reproducibility.

See Installation for Docker Compose and the single-run docker run alternatives.

Clone this wiki locally