HolyArrs

One app to find, download and organize your shows, movies and music

  • holyarrs/holyarrs:1.2.0
  • v1.2.0
  • Updated 20 Nov 2026
  • port 6754
  • amd64 · arm64
  • Media
  • 2.7k stars

Screenshots

HolyArrs screenshot 1: Explore with trailersHolyArrs screenshot 2: HomeHolyArrs screenshot 3: RequestsHolyArrs screenshot 4: Downloads

Open the app

Web App

http://localhost:6754/

About HolyArrs

HolyArrs is one self-hosted app for your shows, movies and music. It does the jobs of Sonarr, Radarr, Lidarr, Bazarr, Prowlarr and Seerr in one small program: browse like a streaming app, ask for a title, and it finds it, downloads it and files it in your library.

Features

  • Explore page with posters, trailers and scores, like a streaming app
  • Requests: family and friends ask, you approve, it shows up
  • Searches your indexers (Sources), picks the best release with your rules and sends it to your downloader
  • Renames and files downloads into your library and keeps subtitles
  • Calendar, Health page and a red dot for anything that needs you
  • Tells Plex, Jellyfin or Emby when something new lands; OIDC sign-in

How to use

  1. Open HolyArrs from your dashboard right after you install it.
  2. Make the owner account. There is no default password.
  3. Follow the short setup: library folders (/movies, /tv, /music), a downloader and a Source.
  4. Search for a show or movie and press Request.

Before you install

Your libraries come from /DATA/Media/Movies, /DATA/Media/TV Shows and /DATA/Media/Music, and downloads from /DATA/Downloads; change them if yours are elsewhere, and point your downloader at the same downloads folder. PUID/PGID must be able to write to those folders. Open http://[ZIMAOS-IP-ADDRESS]:6754 right after install and make the owner account: whoever opens it first becomes the owner. More settings (OIDC, reverse proxy, save path) are in the Variables tab; add them in the app settings.

The settings in the first table are already in the app settings. To use any other one, open the app settings, add the variable with your value, save, and the app restarts with it. A setting you leave out uses its default.

In the app settings

VariableDefault valueDescription
TZ$TZYour time zone, for the calendar, schedules and logs. It is filled in from your ZimaOS time zone.
PUID$PUIDThe user HolyArrs runs as. It must be able to write to your media and download folders. It is filled in by ZimaOS.
PGID$PGIDThe group HolyArrs runs as. It is filled in by ZimaOS.

Files

VariableDefault valueDescription
UMASK022Permission bits new files leave out. Use 002 when a group must write too.
HOLYARRS_SAVE_PATH—Your downloader's save folder as the downloader sees it, like /downloads. Sent with every download.
HOLYARRS_FOLLOW_LINKS—Set to 1 to use video and music files that are symlinks.
HOLYARRS_READONLY_DOWNLOADERS—Downloaders HolyArrs must never change, by id or address, separated by commas.

Server

VariableDefault valueDescription
HOLYARRS_URL_BASE—Serve HolyArrs under a path behind a reverse proxy, like /holyarrs.
HOLYARRS_ALLOWED_HOSTS—Extra host names people use to reach HolyArrs, separated by commas, like holyarrs.example.com. IP addresses and localhost always work.
HOLYARRS_TRUSTED_PROXIES—Your reverse proxy's address or network, so HolyArrs sees real client addresses.
HOLYARRS_LOW_MEMORY—1 forces low-memory mode on, 0 forces it off. Left out, it turns on by itself on small machines.
HOLYARRS_SAFE_MODE—Set to 1 to start only the core (sign-in, library, settings, backups) while you fix a problem. Remove it afterwards.
HOLYARRS_METADATA_MODE—Where posters and details come from: full (the HolyArrs server), own (your own keys) or off.

Sign in with OIDC

VariableDefault valueDescription
HOLYARRS_OIDC_ENABLEDfalseSet to true to turn on single sign-on.
HOLYARRS_OIDC_ISSUER—Your provider's exact https issuer, like https://id.example.com.
HOLYARRS_OIDC_CLIENT_ID—The client ID from your provider.
HOLYARRS_OIDC_CLIENT_SECRET_FILE—A file holding the client secret, like /config/oidc-secret.txt. Leave it out for a public client.
HOLYARRS_OIDC_REDIRECT_URL—Your address plus /api/v1/auth/oidc/callback, like https://holyarrs.example.com/api/v1/auth/oidc/callback.
HOLYARRS_OIDC_ALLOW_JOINfalseSet to true so new people join as members who can only ask.
HOLYARRS_OIDC_ALLOW_LOCAL_NETWORKfalseSet to true when your provider is on your home network.
docker-compose.yml
name: holyarrs

services:
  holyarrs:
    image: holyarrs/holyarrs:1.2.0
    container_name: holyarrs
    restart: unless-stopped
    stop_grace_period: 40s
    network_mode: bridge
    environment:
      - TZ=$TZ
      - PUID=$PUID
      - PGID=$PGID
    ports:
      - target: 6262
        published: "6754"
        protocol: tcp
    volumes:
      - type: bind
        source: /DATA/AppData/$AppID/config
        target: /config
        bind:
          create_host_path: true
      - type: bind
        source: /DATA/Media/Movies
        target: /movies
        bind:
          create_host_path: true
      - type: bind
        source: /DATA/Media/TV Shows
        target: /tv
        bind:
          create_host_path: true
      - type: bind
        source: /DATA/Media/Music
        target: /music
        bind:
          create_host_path: true
      - type: bind
        source: /DATA/Downloads
        target: /downloads
        bind:
          create_host_path: true
    healthcheck:
      test: ["CMD", "/holyarrs", "-healthcheck"]
      interval: 30s
      timeout: 10s
      retries: 3
      start_period: 30s
    deploy:
      resources:
        limits:
          cpus: "2.00"
          memory: 1024M
        reservations:
          cpus: "0.10"
          memory: 128M
    labels:
      icon: https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/holyarrs/icon.png
    x-casaos:
      id: com.icestore.holyarrs
      envs:
        - container: TZ
          description:
            en_US: >-
              Your time zone, for the calendar, schedules and logs. It is
              filled in from your ZimaOS time zone.
        - container: PUID
          description:
            en_US: >-
              The user HolyArrs runs as. It must be able to write to your
              media and download folders. It is filled in by ZimaOS.
        - container: PGID
          description:
            en_US: >-
              The group HolyArrs runs as. It is filled in by ZimaOS.
      ports:
        - container: "6262"
          description:
            en_US: HolyArrs web app, published on host as 6754
      volumes:
        - container: /config
          description:
            en_US: >-
              Databases, settings, the master key, backups and logs. Back it
              up. Keep it on a local disk, never a network share.
        - container: /movies
          description:
            en_US: Your movie library, from /DATA/Media/Movies.
        - container: /tv
          description:
            en_US: Your shows library, from /DATA/Media/TV Shows.
        - container: /music
          description:
            en_US: Your music library, from /DATA/Media/Music.
        - container: /downloads
          description:
            en_US: >-
              Your downloader's download folder, from /DATA/Downloads.
              Point your downloader at the same folder.

x-casaos:
  id: com.icestore.holyarrs
  architectures:
    - amd64
    - arm64
  main: holyarrs
  author: HSinghHira
  category: Media
  developer: HolyArrs
  icon: https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/holyarrs/icon.png
  thumbnail: https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/holyarrs/screenshot-1.webp
  screenshot_link:
    - https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/holyarrs/screenshot-1.webp
    - https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/holyarrs/screenshot-2.webp
    - https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/holyarrs/screenshot-3.webp
    - https://cdn.jsdelivr.net/gh/HSinghHira/IceStore@main/Apps/holyarrs/screenshot-4.webp
  title:
    en_US: HolyArrs
  tagline:
    en_US: One app to find, download and organize your shows, movies and music
  description:
    en_US: >-
      HolyArrs is one self-hosted app for your shows, movies and music. It
      does the jobs of Sonarr, Radarr, Lidarr, Bazarr, Prowlarr and Seerr in
      one small program: browse like a streaming app, ask for a title, and it
      finds it, downloads it and files it in your library.


      **Features**


      - Explore page with posters, trailers and scores, like a streaming
        app

      - Requests: family and friends ask, you approve, it shows up

      - Searches your indexers (Sources), picks the best release with your
        rules and sends it to your downloader

      - Renames and files downloads into your library and keeps subtitles

      - Calendar, Health page and a red dot for anything that needs you

      - Tells Plex, Jellyfin or Emby when something new lands; OIDC
        sign-in


      **How to use?**


      1. Open HolyArrs from the ZimaOS dashboard right after you install
         it.

      2. Make the owner account. There is no default password.

      3. Follow the short setup: library folders (/movies, /tv, /music), a
         downloader and a Source.

      4. Search for a show or movie and press Request.
  tips:
    before_install:
      en_US: >-
        1. Your libraries come from /DATA/Media/Movies, /DATA/Media/TV Shows
           and /DATA/Media/Music. Change them if yours are somewhere else.


        2. Your downloads come from /DATA/Downloads. Point your downloader
           (like qBittorrent) at the same folder.


        3. More settings, like OIDC sign-in and the downloader's save path,
           are listed on the HolyArrs page at
           https://icestore.hsinghhira.me/app/holyarrs/ (Variables tab). You
           can add them now or later in the app settings.


        4. Start the installation. It is ready in a few seconds.


        5. Open http://[ZIMAOS-IP-ADDRESS]:6754 right away and make the
           owner account. Whoever opens it first becomes the owner.
  index: /
  port_map: "6754"
  scheme: http
  is_uncontrolled: false
  version: "1.2.0"
  update_at: "2026-11-20"
  release_notes:
    en_US: |-
      - First IceStore release, on port 6754
      - Uses holyarrs/holyarrs 1.2.0 as upstream ships it
      - Libraries from /DATA/Media (Movies, TV Shows, Music) and downloads from /DATA/Downloads
  repo: "https://github.com/HolyArrs/HolyArrs"
  support: "https://github.com/HolyArrs/HolyArrs/issues"
  docs: "https://docs.holyarrs.com/"

Install HolyArrs

Something not working with HolyArrs?

Report it so it gets fixed, or ask for an app that is not here yet.

More Media apps

See all