Mydia
Docker app from grtgbln's Repository
A modern, self-hosted media management platform for tracking, organizing, and monitoring your media library.
Requirements
Additional configuration options documented here: https://github.com/getmydia/mydia#-environment-variables-reference
Overview
Readme
View on GitHubMydia
Code health
TestFlight
Translation status
Mydia is two open-source apps for movies and TV shows:
- Mydia Server is a self-hosted library manager and automated downloader. It replaces a separate Sonarr, Radarr, Prowlarr and Overseerr setup with a single application.
- Mydia Player is a media player for Android, Android TV, iOS, iPadOS, macOS, Windows, Linux and the web. It plays from Plex, Jellyfin, Stash, Mydia Server, local folders and network shares.
Either app can be used on its own. Mydia Player works with existing Plex or Jellyfin servers without Mydia Server installed, and Mydia Server can manage a library on disk for any other media player. Running both together adds peer-to-peer remote streaming, shared user accounts and server-side transcoding for offline downloads.
[!TIP] Help translate Mydia. Translations are managed on Weblate in the browser with a free account.
Translation status
Mydia Server
Comparison with the *arr stack
Running a full *arr setup typically means deploying four or five separate services and keeping their settings in sync across each one.
| Mydia Server | The *arr stack | |
|---|---|---|
| Movies and TV | Single app, library and set of quality profiles | Radarr for movies and Sonarr for TV, configured separately |
| Indexers | Prowlarr, Jackett, or built-in Cardigann definitions (experimental) | Prowlarr or Jackett |
| User accounts and requests | Built-in accounts, guest roles and approval workflow | Requires Overseerr or Ombi |
| Single sign-on | Built-in OIDC support | Local login, or external proxy auth |
| Configuration | Web UI, YAML file or environment variables | Web UI only |
| Debrid | Built-in providers alongside torrent and Usenet clients | Requires third-party bridge tools |
| Remote playback | Direct peer-to-peer streaming to Mydia Player without port forwarding or a VPN | Requires a separate media server |
Download clients, indexers and libraries can be defined in a YAML file or environment variables so a new container starts already configured. Settings loaded from files or environment variables are shown in the web UI as read-only, while remaining settings stay editable in the browser.
Features
- Library and metadata. Scans local folders or S3 buckets and fetches posters, descriptions and episode data from TMDB and TVDB.
- Automated downloads. Monitors missing movies and episodes, selects releases matching your languages, quality profile and custom formats, and upgrades existing files when higher-scoring releases appear. How release selection works.
- Download clients. Connects to qBittorrent, Transmission, rqbit, SABnzbd, NZBGet and debrid providers.
- Requests. Guest users can request movies and shows for an admin to approve.
- Import lists. Syncs TMDB watchlists, popular and trending lists (experimental).
- Plugins. Runs WebAssembly plugins in a sandbox with explicit user approval for network hosts, events and library access.
- Database. Uses SQLite by default, with optional PostgreSQL support.
- Themes and localization. Includes 14 light and dark themes and community-maintained translations.
| Movies | TV Shows | Series | Calendar |
|---|---|---|---|
![]() |
![]() |
![]() |
![]() |
Quick start
Generate two secret keys:
openssl rand -base64 48 # SECRET_KEY_BASE
openssl rand -base64 48 # GUARDIAN_SECRET_KEY
Save the following as docker-compose.yml, replace the secret placeholders with
the generated keys, and change /path/to/media to your media directory:
services:
mydia:
image: ghcr.io/getmydia/mydia:latest
container_name: mydia
environment:
- PUID=1000
- PGID=1000
- TZ=America/New_York
- SECRET_KEY_BASE=your-secret-key-base-here
- GUARDIAN_SECRET_KEY=your-guardian-secret-key-here
- PHX_HOST=localhost
- MOVIES_PATH=/media/library/movies
- TV_PATH=/media/library/tv
volumes:
- ./config:/config
- /path/to/media:/media
ports:
- 4000:4000
restart: unless-stopped
Run docker compose up -d, open http://localhost:4000 and create an admin
account. See the how-to guides
for NixOS, PostgreSQL, reverse proxies and OIDC single sign-on.
Mydia Player
Mydia Player is a client for existing media servers and file shares, similar in scope to Infuse. It is open source under the AGPL-3.0, free to use without a paid tier, and runs on Android, Android TV, iOS, iPadOS, macOS, Windows, Linux and the web.
| Mydia Player | Infuse | |
|---|---|---|
| License | Open source (AGPL-3.0) | Proprietary |
| Price | Free | Free tier; Pro requires a subscription or lifetime purchase |
| Platforms | Android, Android TV, iOS, iPadOS, macOS, Windows, Linux, web | iOS, iPadOS, tvOS, macOS, visionOS |
| Servers | Plex (with Home profiles), Jellyfin, Stash, Mydia Server | Plex, Jellyfin, Emby |
| File sources | Local folders, SMB and WebDAV with metadata matching (beta) | SMB, NFS, WebDAV, FTP and cloud drives |
| Casting | Chromecast, DLNA and AirPlay | AirPlay |
| Offline downloads | Supported across all servers; Mydia Server can transcode to smaller sizes first | Supported (Pro) |
| Continue watching | Combined row across all connected servers | Per library, with Trakt sync |
| Remote access | Encrypted peer-to-peer connection to Mydia Server without port forwarding or a VPN | Depends on how your server or share is exposed |
| Home | Shows |
|---|---|
![]() |
![]() |
Install
| Platform | Download | Notes |
|---|---|---|
| Android and Android TV | Download APK | Allow installs from unknown sources on first install; updates in-app afterward |
| iOS | Install via TestFlight | Requires the TestFlight app |
| macOS | Download .dmg | Notarized by Apple, with built-in updates |
| Windows | irm https://mydia.dev/install.ps1 | iex in PowerShell, or download installer |
Per-user install. Running the PowerShell script avoids the SmartScreen prompt shown for the unsigned installer |
| Linux | Flatpak or .tar.gz | Flatpak recommended |
| Web | Served by Mydia Server at /player |
Included with Mydia Server |
See the download page for all platforms and Connect Plex, Jellyfin or Stash for setup instructions.
Better together
When Mydia Player is connected to Mydia Server:
- Peer-to-peer remote streaming. The player connects to your server over an encrypted peer-to-peer link without port forwarding, dynamic DNS or a VPN, using a relay if a direct UDP connection is blocked. How remote access works.
- Transcoded offline downloads. Mydia Server can transcode movies and episodes to smaller files before sending them to a phone or laptop.
- Shared accounts and watch history. Users sign in to Mydia Player with their Mydia Server credentials, and watch progress is stored per account.
- Built-in web player. Mydia Server serves the web build of Mydia Player at
/player.
Documentation
Documentation is hosted at docs.mydia.dev:
- Tutorials for initial setup and first library import
- How-to guides for installation, download clients, indexers and deployment
- Reference for environment variables, configuration files, database options and the API
- Explanation for architecture, release scoring and remote access
Contributing
./dev up -d # Start development environment
./dev mix ecto.migrate # Run migrations
./dev mix test # Run tests
./dev mix precommit # Run all checks
See the Development Guide
for the server and player/docs/ for the player.
Translations
Mydia Server and Mydia Player are translated on Weblate. See TRANSLATING.md for terminology and formatting conventions.
Documentation site
The documentation site uses MkDocs, Material for MkDocs and uv:
uv sync --project docs # Install dependencies
uv run --project docs mkdocs serve # Serve at http://localhost:8000
uv run --project docs mkdocs build # Build static site to /site
License
Media gallery
1 / 5Categories
Related apps
Explore more like this
Explore allLinks
Details
ghcr.io/getmydia/mydia:latestRuntime arguments
- Web UI
http://[IP]:[PORT:4000]/- Network
bridge- Privileged
- false
Template configuration
Container Port: 4000
- Target
- 4000
- Default
- 4000
- Value
- 4000
Generate with 'openssl rand -base64 48'
- Target
- SECRET_KEY_BASE
Generate with 'openssl rand -base64 48'
- Target
- GUARDIAN_SECRET_KEY
Change to your domain or IP address
- Target
- PHX_HOST
- Default
- localhost
- Value
- localhost
Path to your movies folder on the host system
- Target
- /media/movies
Path to your TV shows folder on the host system
- Target
- /media/tv
Path to your downloads folder on the host system
- Target
- /media/downloads
Path to the configuration folder
- Target
- /config
- Default
- /mnt/user/appdata/mydia/config
- Value
- /mnt/user/appdata/mydia/config
Internal application port. Not recommended to change.
- Target
- PORT
- Default
- 4000
- Value
- 4000
Internal path to movies folder. Not recommended to change.
- Target
- MOVIES_PATH
- Default
- /media/movies
- Value
- /media/movies
Internal path to TV shows folder. Not recommended to change.
- Target
- TV_PATH
- Default
- /media/tv
- Value
- /media/tv
Internal path to the database file. Not recommended to change.
- Target
- DATABASE_PATH
- Default
- /config/mydia.db
- Value
- /config/mydia.db





