HolyArrs/HolyArrs: One self-hosted app for your shows, movies and music.

One self-hosted app for your shows, movies and music. - HolyArrs/HolyArrs

Summary

HolyArrs is a Go-based, self-hosted app for browsing, requesting, release selection, and library organization across shows, movies, and music. It gives homelab and NAS operators one control plane for a stack that might otherwise involve Sonarr, Radarr, Lidarr, Bazarr, Prowlarr, and Seerr/Overseerr, while retaining separately operated downloaders and media servers.

What it is useful for

A practical workflow is: someone requests a show or season; the owner approves it, or a trusted user skips the queue; HolyArrs applies Pick rules for release size, quality, and language; the job goes to qBittorrent, Transmission, Deluge, rTorrent, SABnzbd, or NZBGet; and the result is filed in the library. Plex, Jellyfin, and Emby can then see the media.

It also helps consolidate an existing setup. “Move from other apps” can import folders, titles, quality profiles as Pick rules, exclusions, naming, indexers, download clients, subtitle defaults, request users, and pending requests from common *arr tools and request managers. The move can be previewed with “Try it,” is undoable, and leaves the old apps unchanged, so both systems can run side by side.

Titles, artwork, and charts come from the project’s maintainer-operated metadata server, so users do not need to configure separate metadata API keys. The limitations are explicit: HolyArrs does not download by itself, so a downloader is still required. The 1.0 line has no AI/MCP features or native phone/TV apps; music browsing in Explore is unfinished, and online subtitle discovery is listed as later work. Migration omits custom formats, tags, and history, and never moves media files.

How engineers can use it

Deployment is documented with Docker Compose. Save this as docker-compose.yml, replacing the paths and IDs:

name: holyarrs
services:
  holyarrs:
    image: holyarrs/holyarrs:latest
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=America/New_York
    volumes:
      - /your/local/path:/config
      - /path/to/movies:/movies
      - /path/to/tv:/tv
      - /path/to/music:/music
      - /path/to/downloads:/downloads
    ports:
      - 6262:6262
    restart: unless-stopped

Run docker compose up -d, then open http://your-server:6262 and create the owner account immediately; there is no default password. First-run setup asks for folders, a downloader, and a Source, such as a Torznab/Newznab indexer, Prowlarr, or Jackett. Keep /config on local disk and set PUID and PGID to the media-folder owner. Mount downloads and library directories under one shared parent if files should move instead of being copied.

For operations, the README documents docker logs -f holyarrs, docker exec holyarrs /holyarrs doctor, and updates with docker compose pull followed by docker compose up -d. The image supports amd64, arm64, and armv7. The repository is licensed under AGPL-3.0, and contributors are directed to the architecture and development setup guides.