What is fetcharr?

Fetcharr is a containerized CLI application written in Java that connects to *arr stack applications via their APIs to periodically search for missing media items or upgrades to existing files. It was created after Huntarr became unavailable and aims to do one thing well: force *arr apps to search their configured indexers on a schedule, regardless of RSS feed availability. The tool supports up to 100 instances per *arr type, offers per-instance configuration overrides, includes a plugin system for extensibility, and provides caching options (file-based or in-memory) to reduce API calls. It runs as a scheduled task rather than a long-running server, with configurable search intervals and amounts. Deployment is via Docker, Docker Compose, or Kubernetes with images published on Docker Hub and GitHub Container Registry.

Should you self-host fetcharr?

fetcharr scores 48/100 on selfhost.directory (how scoring works) and ranks #79 of 142 in Media Management. It has 347 GitHub stars.

It shipped 4 stable releases in the past year. The latest, 2.2.1, came out on 17 August 2026. New versions land roughly every 10 days.

Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is MIT-licensed and written mostly in Java.

Its closest alternative on selfhost.directory is Mediastarr (42/100, 31 stars). fetcharr scores higher overall. See fetcharr vs Mediastarr side by side.

Features

Dry Run Mode
Flexible caching
Missing status filtering
Monitored-only filtering
Multi-arr media scanning
Per-instance configuration overrides
Plugin System
Profile cutoff filtering
Proxy Support
Scheduled automated searches
SSL certificate verification
Tag-based exclusion
User namespace remapping

How to install fetcharr

Install fetcharr with Docker

Docker Engine

Environment variables

VERIFY_CERTS, SSL_PATH, SEARCH_AMOUNT, SEARCH_INTERVAL, RADARR_X_URL, RADARR_X_API_KEY, SONARR_X_URL, SONARR_X_API_KEY, LIDARR_X_URL, LIDARR_X_API_KEY, READARR_X_URL, READARR_X_API_KEY, WHISPARR_X_URL, WHISPARR_X_API_KEY, and many more

docker run
-e VERIFY_CERTS=true
-e SSL_PATH=/etc/ssl/certs/ca-bundle.crt
-e SEARCH_AMOUNT=5
-e SEARCH_INTERVAL=1hour
-e RADARR_0_URL=https://radarr.home.lab
-e RADARR_0_API_KEY=e8ea891d72ff973fa6db0d34369a60a7
-e SONARR_0_URL=https://sonarr.home.lab
-e SONARR_0_API_KEY=71730b5dfaa4293fe0c050844c10df66
-e SONARR_1_URL=https://anime.home.lab
-e SONARR_1_API_KEY=bdb84dc8e4b787c76be8aae2dfe9bd19
-v ./config:/app/config
-v ./cache:/app/cache
-v ./logs:/app/logs
-v ./plugins:/app/plugins
egg82/fetcharr:latest

Requires at least one *arr instance configured with URL and API key

Install fetcharr with Docker Compose

Docker Compose

Environment variables

VERIFY_CERTS, SSL_PATH, SEARCH_AMOUNT, SEARCH_INTERVAL, RADARR_X_URL, RADARR_X_API_KEY, SONARR_X_URL, SONARR_X_API_KEY, LIDARR_X_URL, LIDARR_X_API_KEY, READARR_X_URL, READARR_X_API_KEY, WHISPARR_X_URL, WHISPARR_X_API_KEY, and many more

services: fetcharr: image: egg82/fetcharr:latest container_name: fetcharr hostname: fetcharr environment: - VERIFY_CERTS=true - SSL_PATH=/etc/ssl/certs/ca-bundle.crt - SEARCH_AMOUNT=5 - SEARCH_INTERVAL=1hour - RADARR_0_URL=https://radarr.home.lab - RADARR_0_API_KEY=e8ea891d72ff973fa6db0d34369a60a7 - SONARR_0_URL=https://sonarr.home.lab - SONARR_0_API_KEY=71730b5dfaa4293fe0c050844c10df66 - SONARR_1_URL=https://anime.home.lab - SONARR_1_API_KEY=bdb84dc8e4b787c76be8aae2dfe9bd19 volumes: - ./config:/app/config - ./cache:/app/cache - ./logs:/app/logs - ./plugins:/app/plugins restart: unless-stopped

Requires at least one *arr instance configured with URL and API key

Install fetcharr with Kubernetes

Kubernetes cluster with ReadWriteMany storage

Environment variables

VERIFY_CERTS, SSL_PATH, SEARCH_AMOUNT, SEARCH_INTERVAL, RADARR_X_URL, RADARR_X_API_KEY, SONARR_X_URL, SONARR_X_API_KEY, LIDARR_X_URL, LIDARR_X_API_KEY, READARR_X_URL, READARR_X_API_KEY, WHISPARR_X_URL, WHISPARR_X_API_KEY, and many more

apiVersion: v1 kind: Namespace metadata: name: fetcharr

apiVersion: v1 kind: PersistentVolumeClaim metadata: name: config namespace: fetcharr spec: accessModes: - ReadWriteMany resources: requests: storage: 1Gi

apiVersion: v1 kind: PersistentVolumeClaim metadata: name: cache namespace: fetcharr spec: accessModes: - ReadWriteMany resources: requests: storage: 5Gi

apiVersion: v1 kind: PersistentVolumeClaim metadata: name: logs namespace: fetcharr spec: accessModes: - ReadWriteMany resources: requests: storage: 10Gi

apiVersion: v1 kind: PersistentVolumeClaim metadata: name: plugins namespace: fetcharr spec: accessModes: - ReadWriteMany resources: requests: storage: 5Gi

apiVersion: apps/v1 kind: Deployment metadata: labels: app.kubernetes.io/name: fetcharr name: fetcharr namespace: fetcharr spec: replicas: 1 selector: matchLabels: app.kubernetes.io/name: fetcharr template: metadata: labels: app.kubernetes.io/name: fetcharr spec: securityContext: fsGroup: 1000 fsGroupChangePolicy: OnRootMismatch seccompProfile: type: RuntimeDefault containers: - image: egg82/fetcharr: name: fetcharr securityContext: runAsUser: 1000 runAsGroup: 1000 allowPrivilegeEscalation: false runAsNonRoot: true capabilities: drop: ["ALL"] resources: requests: cpu: 50m memory: 150Mi limits: cpu: 500m memory: 1Gi env: - name: VERIFY_CERTS value: "true" - name: SSL_PATH value: /etc/ssl/certs/ca-bundle.crt - name: SEARCH_AMOUNT value: "5" - name: SEARCH_INTERVAL value: 1hour - name: RADARR_0_URL value: https://radarr.home.lab - name: RADARR_0_API_KEY value: e8ea891d72ff973fa6db0d34369a60a7 - name: SONARR_0_URL value: https://sonarr.home.lab - name: SONARR_0_API_KEY value: 71730b5dfaa4293fe0c050844c10df66 - name: SONARR_1_URL value: https://anime.home.lab - name: SONARR_1_API_KEY value: bdb84dc8e4b787c76be8aae2dfe9bd19 volumeMounts: - mountPath: /app/config name: config - mountPath: /app/cache name: cache - mountPath: /app/logs name: logs - mountPath: /app/plugins name: plugins volumes: - name: config persistentVolumeClaim: claimName: config - name: cache persistentVolumeClaim: claimName: cache - name: logs persistentVolumeClaim: claimName: logs - name: plugins persistentVolumeClaim: claimName: plugins

Requires at least one *arr instance configured with URL and API key; replace <use-real-version> with actual version tag