Skip to content

Installation Unraid

chodeus edited this page May 22, 2026 · 4 revisions

Installation — Unraid

CHUB isn't in the Community Applications store yet. Two ways to install:

Option A — Drop in the XML template (pre-fills the form)

I ship an Unraid Docker template at deploy/unraid/chub.xml. Putting it in your Unraid box's user-templates folder makes it appear in the Template dropdown of Docker → Add Container with all the paths, ports, and env vars pre-filled.

From a terminal on the Unraid box:

wget -O /boot/config/plugins/dockerMan/templates-user/chub.xml \
  https://raw.githubusercontent.com/chodeus/chub/main/deploy/unraid/chub.xml

Then in the web UI: Docker → Add Container → Template dropdown → pick chub. Adjust the host paths and TZ to match your setup, then Apply.

Defaults: PUID=99, PGID=100, UMASK=002, paths under /mnt/user/appdata/chub and /mnt/user/data.

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