Documentation
Everything you need to install, set up and look after Mediarium. These pages are built from the same files as the code, so they always match the version you run.
Start with the install guideImport your library
Getting started
Install guide
Install Mediarium with Docker: folders, ports, first run, updating, backups and fixing problems.
Synology
Install Mediarium on a Synology NAS with Container Manager, step by step, including next to Radarr and Sonarr.
Unraid
Install Mediarium on Unraid from the Docker tab with Add Container, with the same fields as the compose file.
QNAP
Install Mediarium on a QNAP NAS with Container Station 3 by pasting the compose file.
Linux and Raspberry Pi
Install Mediarium with Docker on a regular Linux server or a 64-bit Raspberry Pi 3, 4 or 5.
What runs where
One Docker image for every platform: Linux, Raspberry Pi, NAS systems, Windows and Mac with Docker Desktop.
Using Mediarium
Import your library
Bring in what you already have, without moving files.
Library
Your movies, shows and more: filters, changing many titles at once, second copies and quality.
Discover
Find something new to add: more like your library, browse by genre and year, and the Add dialog.
Downloading
Usenet and torrents: the torrent port, seeding, debrid services, download clients and the download line.
Activity
What is downloading, waiting in line or failed, the download clients tab, requests and history.
Quality profiles
Pick the quality and the fallback order.
Import lists
Add movies and shows by themselves from lists on Trakt, TMDB, IMDb, MDBList and Letterboxd.
Indexers and Search
Where Mediarium looks for releases: Usenet and torrent indexers, community sites and private trackers.
IRC announce
Grab a release the moment a tracker announces it in its IRC channel.
Media servers
Plex, Jellyfin, Emby, Audiobookshelf and Kavita.
Music
Artists, albums, audio quality, playlists and the built-in music player.
Ebooks and audiobooks
Find books, and read or listen in Mediarium Books.
Languages
Six screen languages, titles and posters in about thirty, and how to help with a translation.
Other apps
Connect Overseerr, Homepage, nzb360 and other apps that expect Radarr or Sonarr.
Media types
Switch movies, TV, music, ebooks and audiobooks on or off.
Subtitles
Subtitles matched to your file, and fixing their timing.
Notifications
Get told about downloads and problems by email, Discord, Telegram, Matrix, push and more.
VPN protection
A built-in WireGuard tunnel for torrents.
Accounts
Admins, family accounts, permissions, the Viewer role, requests with limits, read-only API keys and single sign-on.
Move from other apps
Copy your setup from Radarr, Sonarr, Prowlarr, SABnzbd and other apps. It only reads, and moves no files.
Your own script
Run a script of your own after each import.
Logs and errors
What the messages mean, what to try when a download fails, and how to copy a report for support.
Report a problem or share an idea
Send it privately or as a GitHub issue, from inside the app.
Safety and legal
Reference
Features
Everything Mediarium does today, compared with the apps it replaces, and what it does not do yet.
Environment variables
Every environment variable Mediarium reads for the container, generated from the code.
Settings keys
Every setting Mediarium stores in its database, with its default value, generated from the code.
API routes
Every HTTP endpoint of Mediarium and who may call it (public, any account or admin), generated from the code.
Problem codes
The codes shown on the Logs and errors page, what each one means and what to try.