Skip to content

Installation Unraid

chodeus edited this page Oct 22, 2026 · 5 revisions

🏠 Home › Installation › Unraid

Installation — Unraid

CHUB isn't in Community Applications yet. Use the bundled template or fill in the Add Container form by hand.

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, TZ=Etc/UTC, image :latest, paths under /mnt/user/appdata and /mnt/user/data. The template has no /posters mapping; add one if your poster modules need it.

Option B — Manual Add Container

Field Value
Name chub
Repository ghcr.io/chodeus/chub:latest (or :full — see Image tags)
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 and plex_maintenance)

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 release tag (ghcr.io/chodeus/chub:vX.Y.Z, or vX.Y.Z-full) is more stable than :latest, which moves with every change on main.

Next: First Run · Related: Installation

Clone this wiki locally