A self-hosted server management platform that runs as a Docker container with full host access. Manage Docker apps, storage, reverse proxies, backups, and more — all from a clean web UI on port 9700.
Stars help others discover HuntarrOS — if you find it useful, click the ⭐ in the upper-right corner!
My 12-year-old daughter loves singing, dancing, and exploring STEM. She's an A-B honor roll student with big dreams for the future. Any donation you make will go directly toward her college fund, helping her turn those dreams into reality. Thank you for your support!
🎯 Check out Huntarr. Automated media hunting for Sonarr, Radarr, Lidarr, Readarr, and Whisparr — plus built-in Movie Hunt, TV Hunt, Index Master, NZB Hunt, and Requestarr modules. Finds missing content and upgrades quality continuously.
One command. That's it. Run as root on any supported Linux system:
sudo bash -c "$(curl -fsSL https://raw.githubusercontent.com/plexguide/HuntarrOS.com/main/install.sh)"If curl isn't installed (common on minimal Debian/Ubuntu), install it first:
sudo apt-get update && sudo apt-get install -y curlThe installer will:
- Install Docker if it's not already present
- Create the
/pgdirectory structure for all HuntarrOS data - Pull and launch the HuntarrOS container
Once complete, open your browser to http://<your-server-ip>:9700 and you're in.
Browse and deploy Docker apps from a curated catalog with one click. The catalog auto-syncs from the HuntarrOS Apps repo on GitHub — new apps show up automatically every 6 hours, no container rebuild needed.
Want to add your own apps? Fork the Apps repo, add your JSON app definitions, and point HuntarrOS to your fork for a personal app store.
Set up Cloudflare Tunnels or Traefik with automatic SSL certificates for all your apps. Configure domains, manage tunnels, and route traffic — all from the web UI.
Pool multiple drives into a single unified mount point. The guided wizard walks you through selecting drives, choosing a merge policy, and configuring fstab — no command line needed.
| Feature | Description |
|---|---|
| Docker Management | Start, stop, restart, and remove containers. View logs, ports, and resource usage. |
| Backup & Restore | Back up and restore your /huntarr/appdata configuration. |
| Account System | Multi-user support with owner and standard user roles. |
| Automatic Updates | One-click update from the web UI pulls the latest image and recreates the container. |
HuntarrOS runs as a Docker container, so any Linux distro that supports Docker works. The install script uses the official Docker install method (get.docker.com).
These distros are tested and supported by Docker's install script:
| Distro | Versions | Architectures |
|---|---|---|
| Ubuntu | 22.04, 24.04 | x86_64, arm64 |
| Debian | 11 (Bullseye), 12 (Bookworm) | x86_64, arm64 |
| Fedora | 40, 41 | x86_64, arm64 |
| CentOS | Stream 9 | x86_64, arm64 |
| RHEL | 9 | x86_64, arm64 |
Docker doesn't officially test these, but they follow the same package repos as their parent distro:
| Distro | Based On | Notes |
|---|---|---|
| Rocky Linux 9 | RHEL 9 | Uses CentOS/RHEL Docker repo. |
| AlmaLinux 9 | RHEL 9 | Uses CentOS/RHEL Docker repo. |
| Linux Mint 21.x / 22.x | Ubuntu | Uses Ubuntu Docker repo. |
| Raspberry Pi OS (64-bit) | Debian | Must use 64-bit OS. 32-bit is not supported — HuntarrOS only builds arm64 images. |
Docker images are built for linux/amd64 and linux/arm64:
- x86_64 servers and desktops
- ARM64 devices (Raspberry Pi 4/5 with 64-bit OS, Oracle Cloud ARM instances, etc.)
- Windows / macOS — HuntarrOS requires Linux-specific features (privileged container,
nsenter, host PID namespace). WSL2 is untested and not supported. - 32-bit ARM — Only 64-bit ARM (arm64/aarch64) images are built. 32-bit Raspberry Pi OS will not work.
- Distros without systemd — The install script uses
systemctlto enable Docker. Alpine, Void, and similar distros need manual Docker setup before running the install script.
HuntarrOS runs as a privileged Docker container with host-level access:
docker run -d \
--name huntarros \
--restart unless-stopped \
--privileged \
--pid=host \
--net=host \
-v /var/run/docker.sock:/var/run/docker.sock \
-v /huntarr/appdata/huntarros:/config \
-v /:/host \
-e TZ=America/New_York \
huntarr/huntarros:latest| Flag | Why |
|---|---|
--privileged |
Manage host storage (mergerfs, mounts, fstab) |
--pid=host |
Execute host commands via nsenter |
--net=host |
Direct access to port 9700, no port mapping needed |
-v /var/run/docker.sock |
Manage other Docker containers |
-v /huntarr/appdata/huntarros:/config |
Persistent configuration |
-v /:/host |
Host filesystem access for system management |
All HuntarrOS data lives under /pg on the host:
/huntarr/
├── appdata/
│ └── huntarros/ → HuntarrOS config (mounted as /config in container)
└── programs/ → App installs managed by HuntarrOS
# View logs
docker logs huntarros -f
# Restart
docker restart huntarros
# Stop
docker stop huntarros
# Update to latest version
docker pull huntarr/huntarros:latest
docker stop huntarros && docker rm huntarros
# Re-run the install command or docker run aboveOr just use the Update button in the HuntarrOS web UI.
Huntarr — Automated media hunting for Sonarr, Radarr, Lidarr, Readarr, and Whisparr. Finds missing content and upgrades quality with built-in Movie Hunt, TV Hunt, Index Master, NZB Hunt, and Requestarr modules.
Seekandwatch — A streamlined media discovery and watchlist tool for finding and tracking content across your media stack.
Licensed under the GNU General Public License v3.0.
