Installation Unraid

🏠 Home › Installation › Unraid

Installation — Unraid

Install CHUB on Unraid using the bundled Docker template or by filling the Add Container form by hand.

CHUB isn't in Community Applications yet. Pick one of the two options below.

Option A — Drop in the XML template

The template pre-fills paths, ports, and env vars in the Docker → Add Container → Template dropdown.

1. From a terminal on the Unraid box, fetch it into the user-templates folder:

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

2. In the web UI: Docker → Add Container → pick chub from the Template dropdown.

3. Adjust host paths and TZ, then Apply.

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

Option B — Manual Add Container

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/ (cross-volume nohl/jduparr walks)
/kometa	your Kometa asset folder
/plex	Plex's Library/Application Support/Plex Media Server/ (only for poster_cleanarr)

Variables

Variable	Value
PUID	99
PGID	100
UMASK	002
TZ	your timezone

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

Tips

• Auto-start under Advanced view to bring CHUB up with the array.
• Unraid writes as 99:100; CHUB runs as the same pair by default, so appdata is writable out of the box. More on PUID/PGID.
• Pinning: a date tag (ghcr.io/chodeus/chub:2026.04.20) is more stable than :latest.

---

Next: First Run · Related: Installation