Middlewarr

Your *arr apps.
Access on your terms.

A lightweight, self-hosted proxy for Radarr, Sonarr, and the rest.

Connect dashboards, request managers, and scripts without sharing your service API keys. Give each app a proxy key and choose which requests it can make. Middlewarr checks those requests before forwarding them to your services.

Get StartedView on GitHub
01

Stable Routes

Point apps at /proxy/{app} so you can move a service without reconfiguring every app.

02

Separate Credentials

Apps use their own proxy keys. Middlewarr adds the service’s API key before forwarding each request.

03

Controlled Access

Choose the HTTP methods and paths each app can use. Requests outside those rules are blocked and logged.

04

Health & Request Logs

Check service health and follow request logs in the admin interface.

From app to service

Middlewarr checks the app’s key and access rules, then adds the service’s API key and forwards the request. The response returns through Middlewarr to the app.

Example Client Requests
HomepageGET /api/v3/calendar?start=2026-09-01
SeerrPOST /api/v3/command
BazarrGET /api/v3/episode/1842
ProfilarrPUT /api/v3/qualityprofile/7
quiGET /api/v3/parse?title=Arrival.2016
ScriptDELETE /api/v3/movie/42
HomepageGET /api/v3/health
MiddlewarrRequest policy
  1. AuthenticateProxy key accepted
  2. Match EndpointCheck method + path
  3. Attach Service KeyAdd the service credential
  4. Forward & LogRecord request and response
Request allowed200
Endpoint blocked403
RadarrMovies
SonarrSeries
Notification ProvidersSend alerts when access or upstream health needs attention.
TelegramGotifyDiscord

Run It on Your Infrastructure

You’ll need Git and Docker. Clone the repository, copy the sample settings, and build the container. Your configuration, database, templates, and logs stay in one persistent data directory.

Create your administrator account on first run. Admin sign-in and app proxy keys are separate. Use HTTPS through a reverse proxy when accessing Middlewarr over a network.

Build and Start Middlewarr
git clone https://github.com/middlewarr/middlewarr
cd middlewarr
mkdir -p data
cp settings.sample.yml data/settings.yml
docker build -t middlewarr .
docker run -d --name middlewarr \
  -p 127.0.0.1:9292:80 \
  -v "$PWD/data:/data" \
  --restart unless-stopped middlewarr

Open localhost:9292 on the machine running Docker to create your account. The setup guide covers remote access and reverse proxies.

  • One self-hosted container
  • Persistent data in /data
  • Administrator sign-in included
Read the Setup Guide