Build
Connect & operate
Design & teams
Start hereScope a build in one callBring a spec, a wireframe, or a paragraph. You leave with an architecture, a timeline, and a number.Book a scoping call
AI software
LLM & data systems
Vibe coding
Ready to ship?Put AI where the work isAgents, RAG, and private LLMs wired into the systems your team already uses — not a chatbot bolted to a homepage.Discuss an AI project
Domain firstWe learn your workflow before we model itRegulated, operational, or high-volume — the constraints belong in the schema, not in a training doc.Talk about your domain
Plan smarterEstimate before you commitCost ranges, scope templates, and the questions we ask in discovery — free, no form.Open the cost calculator
Real conversationsTalk with a technical leadNo SDR, no discovery gauntlet. The person on the call is the one who scopes the build.Book a call
Open-Source DevOps · midarrlabs

midarr-server

Midarr is a lightweight, self-hosted media server written in Elixir that displays your existing movie and TV media libraries through a modern web interface. It integrates with Radarr and Sonarr to manage content without duplicating or re-indexing your media files.

Source: GitHub — github.com/midarrlabs/midarr-server
1.4k
GitHub stars
38
Forks
Elixir
Primary language
MIT
License (OSI-approved)

Key facts

Objective fields from the source. Values we can't verify are shown as “Unknown” rather than guessed.

FieldValue
Repositorymidarrlabs/midarr-server
Ownermidarrlabs
Primary languageElixir
LicenseMIT — OSI-approved
Stars1.4k
Forks38
Open issues6
Latest releasev4.3.0 (2024-08-16)
Last updated2026-03-03
Sourcehttps://github.com/midarrlabs/midarr-server

What midarr-server is

Built on Elixir/Phoenix with PostgreSQL backing, Midarr streams media directly from mounted storage and syncs library state via webhooks from Radarr/Sonarr. It provides user authentication, real-time online statuses, and supports H.264/H.265 video with AAC/MP3 audio in MP4/MKV containers.

Quickstart

Get the midarr-server source

Clone the repository and explore it locally.

terminalbash
git clone https://github.com/midarrlabs/midarr-server.gitcd midarr-server# follow the project's README for install & configuration

Need it deployed, integrated, or customized instead? DEV.co ships production installs.

Best use cases

Self-hosted media consumption for small teams

Ideal for households or small groups already running Radarr/Sonarr who want a modern, user-friendly frontend without heavy re-indexing overhead.

Lightweight companion to existing media automation

Sits alongside existing Radarr/Sonarr infrastructure, leveraging their metadata and management without duplicating storage or processing.

Direct streaming from NAS or local storage

Suited for environments with fast local/network storage and compatible media codecs; avoids transcoding overhead through direct playback.

Implementation considerations

  • Requires PostgreSQL database alongside the Elixir service; Docker Compose example provided in README but production HA/failover setup not documented.
  • Media mounts must be identical paths on Midarr, Radarr, and Sonarr containers for path resolution to work; misconfiguration is a common failure point.
  • Webhook tokens for Radarr/Sonarr sync must be manually configured in each integration; no automated discovery or token rotation mechanism.
  • Admin account is set up via environment variables at first boot; no built-in user management API for infrastructure-as-code deployments.
  • Direct streaming assumes adequate network bandwidth and codec support on client browsers; no client-side quality selection or adaptive bitrate documented.

When to avoid it — and what to weigh

  • Codec compatibility concerns — Only supports H.264/H.265 video and AAC/MP3 audio. If your library uses exotic codecs, transcoding is not built-in; client-side playback will fail.
  • No Radarr/Sonarr integration available — Core functionality depends on working Radarr v5.x or Sonarr v4.x instances. Standalone media libraries or other indexers cannot be used directly.
  • Large multi-tenant enterprise deployments — Designed for lightweight, single-organization self-hosting. No documented horizontal scaling, advanced RBAC, or tenant isolation features.
  • Mission-critical uptime without SLA support — Community-maintained project with 6 open issues; no commercial support or SLA guarantees. Downtime responsibility falls entirely on deployer.

License & commercial use

MIT License. Permissive OSI-approved license allowing commercial use, modification, and distribution with attribution. No copyleft obligations.

MIT License permits commercial deployment and modification. However, there is no commercial support entity, SLA, warranty, or indemnification. Deployer assumes all operational and liability risk. Verify internal policy acceptance before production use.

DEV.co evaluation signals

Editorial assessment — not user reviews. Directional, with an explicit confidence level.

SignalAssessment
MaintenanceActive
DocumentationAdequate
License clarityClear
Deployment complexityLow
DEV.co fitGood
Assessment confidenceHigh
Security considerations

Project does not claim security audit or formal threat model. Considerations: (1) Credentials (DB, API keys, OAuth secrets) passed via environment variables—rotation procedures not documented. (2) Real-time online status feature—verify no information leakage across user boundaries. (3) Direct stream access via mounted media—verify file-level permissions and access control to prevent unauthorized library browsing. (4) Webhook tokens used for Radarr/Sonarr sync—verify token storage, expiration, and revocation. (5) No WAF, rate limiting, or DDoS mitigation mentioned. (6) PostgreSQL database credentials must be strongly secured; default healthcheck in example uses trivial test.

Alternatives to consider

Jellyfin

Full-featured media server with built-in library indexing, transcoding, and broader codec support. Heavier footprint; no tight Radarr/Sonarr coupling.

Emby

Commercial media server with advanced features (sync, remote access, transcoding). Proprietary; cost and licensing differ from open-source lightweight approach.

Plex

Mature cloud-backed media server with broad ecosystem. Requires account; less suitable for air-gapped or minimal-footprint deployments.

Software development agency

Build on midarr-server with DEV.co software developers

Midarr integrates with your existing Radarr/Sonarr setup in minutes. Evaluate its codec support, webhook sync, and multi-instance requirements with Devco's technical team to ensure fit for your infrastructure.

Talk to DEV.co

Related open-source tools

Surfaced by semantic similarity across the DEV.co open-source index.

Related on DEV.co

Explore the category and the services that help you build with it.

midarr-server FAQ

Why do I need both Radarr/Sonarr and Midarr?
Radarr/Sonarr handle media discovery, organization, and metadata; Midarr provides a lightweight, modern web UI and user management on top of those services without duplicating their work.
Can Midarr transcode media?
No. Midarr performs direct streaming only. Your media files must be in supported formats (H.264/H.265 video, AAC/MP3 audio, MP4/MKV containers) or playback will fail on the client.
What happens if Radarr/Sonarr webhooks don't fire?
Media sync will stale. The README notes webhooks are required for sync; missing or misconfigured URLs will cause libraries to fall out of sync until manually refreshed.
Is there a multi-instance/high-availability setup guide?
Not documented. Single-instance deployment with PostgreSQL is the standard pattern. Clustering, failover, and load-balancing are not addressed.

Custom software development services

Open-source adoption creates integration work. DEV.co supplies the software development services that close the gap between midarr-server and a running open-source devops system your team can operate.

Ready to Deploy a Lightweight Media Server?

Midarr integrates with your existing Radarr/Sonarr setup in minutes. Evaluate its codec support, webhook sync, and multi-instance requirements with Devco's technical team to ensure fit for your infrastructure.