Deckarr

A free, self-hosted iPhone web app for your media server. It runs as one small container on Unraid and you add it to your Home Screen like a normal app.

Supported services: Sonarr, Radarr, Lidarr, Prowlarr, Bazarr, qBittorrent, SABnzbd, Jellyfin and Unraid 7.2+.

API keys are stored only on the server (/config/config.json, mode 600). The phone never sees them; it talks to Deckarr, and Deckarr talks to your services.

Install on Unraid

From the Apps tab (one click)

1. Open Apps in Unraid and search for Deckarr.
2. Click Install, then Apply. The defaults work for most servers.
3. Continue with First run on the iPhone.

Before Deckarr is listed in Apps

Run this once in the Unraid terminal (the >_ icon top right):

wget -O /boot/config/plugins/dockerMan/templates-user/my-Deckarr.xml \
  https://raw.githubusercontent.com/bjaane/deckarr/main/templates/deckarr.xml

Then go to Docker > Add Container, choose Deckarr under Template, and click Apply.

Docker CLI or Compose

docker run -d --name deckarr --restart unless-stopped \
  -p 8484:8484 \
  -v /mnt/user/appdata/deckarr:/config \
  ghcr.io/bjaane/deckarr:latest

The container fixes the permissions of /config itself and then runs as PUID/PGID (default 99/100, Unraid's nobody:users).

First run on the iPhone

1. Open Safari and go to http://<your-unraid-ip>:8484.
2. Create a password. You type it once per device.
3. Go to Settings > Add a service and add your apps. Use Test connection before saving.
4. Tap Share > Add to Home Screen. Deckarr now opens full screen from its own icon.

Use your Unraid LAN IP for service addresses, for example http://192.168.1.10:8989. localhost inside the Deckarr container points at Deckarr itself.

Where to find the keys

Access away from home

Don't forward port 8484 to the internet. Use one of these instead:

• Tailscale (recommended, free): install Tailscale on Unraid (built in from Unraid 7) and on the iPhone, then open http://<unraid-tailscale-ip>:8484.
• Reverse proxy with HTTPS (Nginx Proxy Manager, SWAG, Caddy): point it at port 8484. Sub-paths such as https://example.com/deckarr/ work. Pass X-Forwarded-Proto so the session cookie is marked secure.

Add the Home Screen icon from the address you'll use most, because the icon remembers that address.

Settings

Forgot the password? Stop the container, delete auth.json in the appdata folder (/mnt/user/appdata/deckarr), and start it again. You'll be asked to create a new one. Your services are kept.

Update

Unraid shows Update ready on the Docker tab when a new version is published. Click it. Your settings are kept.

Back up

Back up /mnt/user/appdata/deckarr. It contains your API keys, so treat it like a password file.

Tip: let Jellyfin pick up new files immediately

In Sonarr and Radarr, go to Settings > Connect > + > Emby / Jellyfin:

1. Turn on On Import and On Upgrade.
2. Turn on Update Library.
3. Enter the Jellyfin address and an API key.

If Sonarr and Jellyfin see the media at different paths (/tv vs /data/tv), fill in the path mapping.

Troubleshooting

The container log in the Docker tab shows server-side errors.

For tinkerers

server/         Node.js server, no dependencies
  index.js      routes, sign-in, static files
  upstream.js   talks to each service, injects credentials
  types.js      list of supported services
public/         the app (plain JavaScript, no build step)
  js/services.js  one adapter per service
  js/views/       Home, Library, Activity, Server, Settings

To add another Sonarr-style app, add an entry to SERVICE_TYPES in server/types.js and to ARR and API_VERSION in public/js/services.js.

Build the image yourself:

docker build -t deckarr .

Run locally without Docker (Node 20+):

npm run dev    # stores settings in ./config, serves on http://localhost:8484