selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

Mediarium logo

Self-host Mediarium

v3.8.0

All-in-one media manager for movies, shows, music and books

ReleaseOpen SourceAGPL-3.0
Updated8 hours ago
LanguageGo
Setup difficultyModerate
MobileResponsive
ThemeDark mode
Stars
271
Ports
8264 (Web UI), 58264 (Torrent client (TCP/UDP))
Docker
ghcr.io/rdborg/mediarium
Install with Docker Compose
Dashboard with media cards and server statusDiscover page with rows of popular and new moviesActivity page showing downloads in progress and queueUpcoming calendar with releases per dayEbook library with covers and statusDashboard on mobile phoneDiscover page on mobile phoneActivity page on mobile phoneLibrary view on mobile phone

What is Mediarium?

Mediarium combines multiple media management tools into one Docker container. It manages movies, TV shows (including anime and daily shows), music, ebooks and audiobooks with built-in Usenet and torrent downloaders, a WireGuard VPN for torrents, configurable quality tiers with upgrade paths, subtitle fetching from OpenSubtitles and SubDL, family accounts with granular permissions and request workflows, and integration with Plex, Jellyfin, Emby, Silo, Audiobookshelf and Kavita. It imports settings and libraries from existing *arr apps without moving files. The web UI includes a built-in ebook reader and audiobook player that sync progress across devices, a discover section with recommendations, a calendar of upcoming releases, and Prometheus metrics. It runs on any 64-bit Linux system including Synology, Unraid, QNAP, TrueNAS SCALE, Raspberry Pi, and Docker Desktop on Windows/Mac. Licensed under AGPL-3.0 with no paid tiers or ads.

Should you self-host Mediarium?

Mediarium scores 52/100 on selfhost.directory (how scoring works) and ranks #60 of 142 in Media Management. It has 271 GitHub stars.

It shipped 10 stable releases in the past year. The latest, v3.8.0, came out on 27 October 2026. New versions land roughly every 1 days.

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

Its closest alternative on selfhost.directory is SoulSync (67/100, 2 321 stars). It scores higher overall, so compare the two before you pick. See Mediarium vs SoulSync side by side.

Features

  • Built-in ebook reader and audiobook player
  • Built-in torrent client
  • Built-in Usenet downloader
  • Cloud Backups
  • Family accounts with permissions
  • Import from other apps
  • Import lists
  • IRC announce
  • Media Server Integration
  • Notifications
  • OPDS and Kobo sync
  • Quality profiles with upgrades
  • Request portal
  • Subtitle fetching
  • WireGuard VPN for torrents

Mediarium README

How to install Mediarium

Install Mediarium with Docker Compose

Environment variables
PUID, PGID, TZ, DOWNLOADS_DIR, MOVIES_DIR, TV_DIR, MUSIC_DIR, EBOOKS_DIR, AUDIOBOOKS_DIR, CONFIG_DIR, APP_PORT, URL_BASE, TRUSTED_PROXIES, ALLOWED_ORIGINS, BUNDLED_FLARESOLVERR, MEDIARIUM_DISABLE_SSO, MEDIARIUM_DISABLE_STATS, MEDIARIUM_IMAGE_VERSION, MEDIARIUM_PAUSE_AUTOMATION, MEDIARIUM_SUPERVISED

mkdir mediarium && cd mediarium curl -fsSLO https://raw.githubusercontent.com/rdborg/Mediarium/main/docker/docker-compose.yml

open docker-compose.yml and set PUID, PGID, TZ and your folders

docker compose up -d

Primary installation method; one image for all platforms (amd64/arm64)

How to configure Mediarium

  • ALLOWED_ORIGINSCORS allowed origins

    CORS allowed origins

  • APP_PORT8264Web UI port

    Web UI port

  • AUDIOBOOKS_DIR/audiobooksAudiobooks folder inside container

    Audiobooks folder inside container

  • BUNDLED_FLARESOLVERRBundled FlareSolverr URL

    Bundled FlareSolverr URL

  • CONFIG_DIR/configConfiguration directory

    Configuration directory

  • DOWNLOADS_DIR/downloadsDownloads folder inside container

    Downloads folder inside container

  • EBOOKS_DIR/ebooksEbooks folder inside container

    Ebooks folder inside container

  • MEDIARIUM_DISABLE_SSODisable SSO and directory sign-in (emergency access)

    Disable SSO and directory sign-in (emergency access)

  • MEDIARIUM_DISABLE_STATSDisable anonymous usage statistics

    Disable anonymous usage statistics

  • MEDIARIUM_IMAGE_VERSIONImage version for update checks

    Image version for update checks

  • MEDIARIUM_PAUSE_AUTOMATIONPause automatic tasks

    Pause automatic tasks

  • MEDIARIUM_SUPERVISEDSupervised mode flag

    Supervised mode flag

  • MOVIES_DIR/moviesMovies folder inside container

    Movies folder inside container

  • MUSIC_DIR/musicMusic folder inside container

    Music folder inside container

  • PGID1000Group ID that owns media folders

    Group ID that owns media folders

  • PUID1000User ID that owns media folders

    User ID that owns media folders

  • TRUSTED_PROXIESprivateTrusted proxy IPs for reverse proxy

    Trusted proxy IPs for reverse proxy

  • TV_DIR/tvTV shows folder inside container

    TV shows folder inside container

  • TZEtc/UTCTimezone

    Timezone

  • URL_BASESub-path for reverse proxy

    Sub-path for reverse proxy

Mediarium releases & version history

FAQ

Which languages does it speak?

UI in English, Spanish, German, French, Brazilian Portuguese, European Portuguese. Titles/posters in ~30 languages. Server messages in English only.

Can I put it behind a reverse proxy, or under a sub-path?

Yes. Put behind HTTPS, never open port 8264 directly. Can run under sub-path like /mediarium with one setting. Can take sign-in from Authelia or Authentik.

What data does it send anywhere?

Nothing by default. Only contacts services you configure, TMDB for metadata, GitHub for updates (can disable). Optional anonymous daily ping (random ID, version, rough device sizes) if admin consents; totals public at mediarium.app/stats.

How do updates and backups work?

Checks GitHub daily for new versions. Update by pulling new image or Update now button for signed releases. Nightly backup of settings/database; download anytime or send to S3/WebDAV. Media files never included.

How does the VPN work?

Built-in WireGuard client for torrents only. Paste .conf from provider. If VPN stops, torrents wait; optional kill switch blocks them without VPN. No extra container permissions needed.

Does it do subtitles?

Yes, once enabled. Searches OpenSubtitles and SubDL in chosen languages, plus add-ons. Prefers exact-file match and can shift out-of-sync subtitles.

What about music, ebooks and audiobooks?

They work end-to-end once enabled under Media types. Ebooks open in built-in reader, audiobooks in player with progress sync. Music has playlists and synced lyrics. OPDS catalogue and Kobo sync available.

Is there a mobile app?

No separate app. The web UI works on phones and can be added to home screen. Mediarium Books installs as its own PWA. Notifications reach phone from browser. Radarr/Sonarr phone apps (nzb360, LunaSea, Ruddarr) can connect.

Can several people use it?

Yes. Everyone gets their own account with granular permissions: add titles or send requests, pick releases, search, retry, get subtitles, play, and choose media types. Viewer role for read-only. Request limits per day/week and read-only API keys for dashboards.

How much memory and disk space does it need?

Image is ~20 MB; no published minimum. Runs on Raspberry Pi (unpacking slow). Keep settings and media on proper disk, not SD card. Optional Cloudflare helper in -full image takes ~250 MB RAM.

What does it run on?

Anything that runs Docker on 64-bit Linux (Intel/AMD or ARM): regular server, Synology, QNAP, Unraid, TrueNAS SCALE, CasaOS/ZimaOS, OpenMediaVault, Portainer, Raspberry Pi 3/4/5 with 64-bit OS. Windows/Mac via Docker Desktop for testing.

Can I keep my existing library, or move from Radarr and Sonarr?

Yes. Point Mediarium at your folders and it adds what's there without moving files. Settings > System > Move from other apps reads setup from Radarr, Sonarr, Prowlarr, SABnzbd and more.

Does it work with Plex, Jellyfin, Emby, Silo and Kodi?

Plex, Jellyfin, Emby and Silo are told to scan when a download is ready; every title gets a Watch button. Books go to Audiobookshelf and Kavita. Kodi reads NFO and artwork files.

Which Usenet providers and indexers work?

Any Usenet provider with a normal server address and login, and any indexer offering a Newznab API. Torrent sites work via community list or Torznab (Prowlarr, Jackett).

Does it provide any content? Is it legal?

No, Mediarium doesn't host, store, index, upload, stream or provide any media. You add your own indexers and are responsible for what you download.

More in Download Management

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…