Plex DBRepair
Plex DBRepair is a one-shot Docker container that runs the official compiled DBRepair release by ChuckPa to repair a corrupted or damaged Plex Media Server…
Platform availability
Available on 1 of 10 platforms
- Unraid
- TrueNAS (not listed)
- Umbrel (not listed)
- ZimaOS (not listed)
- Proxmox (not listed)
- Helm (not listed)
- Mac (not listed)
- Windows (not listed)
- Linux (not listed)
- Any server (not listed)
Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.
12/100 Low
- Maintained
- 0GitHub repository is archived
- Popular
- 144 GitHub stars
- Easy to install
- 351 install platform, install notes, Docker image
- Light to run
- No data
Based on 3 of 4 factors.
Availability: platform listings confirmed today, links checked 33 days ago
- GitHub stars
- 4
- Open issues
- 0
- Last commit
- 2026-10-31
- Latest release
- Production
- Activity
- rising
Checked 10 days ago - source: GitHub (bmartino1/plex-dbrepair-docker)
Resources & Compatibility
ARM (e.g. Raspberry Pi) is not supported.
Checked 54 days ago - source: Docker Hub image tags and published docs
First-install notes
- Set user IDs and volume folders Set PLEX_UID and PLEX_GID (the user and group IDs the container runs as) to match the host account that owns your media and config folders, and mount persistent folders for /config and /transcode. If ownership is wrong, Plex may fail to read media, save its database, or write temporary files. source
- Use claim token and reachable IP Add PLEX_CLAIM (the one-time token from your Plex sign-in link) and ADVERTISE_IP (the address and port other devices should use, usually http://YOUR_IP:32400/) to the container environment. Without them, the server may not link to your Plex account, or devices may not be able to find it. source
- Protect /config when repairing DB If you use the Kubernetes init-container example, it only extracts a database tarball into /config when /config/Library does not already exist. Keep /config persistent and backed up, because it holds Plex settings and database files, so losing it can break the repair or delete your library metadata. source
- Before running the repair Stop Plex first — no Plex container or process should be running during the repair. Mount your Plex appdata directory (e.g. /mnt/user/appdata/plex) into this container; mount the parent appdata folder, not the Library folder itself, and it must contain 'Library/Application Support/Plex Media Server'. Take a verified backup before starting, as the tool modifies your Plex SQLite database directly. W source
- Plex version compatibility Do not run this tool on Plex 1.43.0 or later. Plex changed its full-text search (FTS) SQL schema in that release, so the database repair may not complete correctly on those versions. source
- Project status The Docker repository is archived, so no further updates are expected. source
Fetched 5 days ago - each note links to its source
Variants
Alternatives (12)
- Airwave - Airwave is a self-hostable service that turns your Plex library into custom, always-on live TV channels with a channel guide, recording, an…
- Ampache - Ampache is a self-hosted, web-based media server that streams and manages your music and video libraries from any device.
- Channels - Channels DVR is a self-hosted digital video recorder and streaming server that records live TV channels and lets you watch them alongside y…
- Emby - Emby is a self-hosted media server that organizes personal video, music, photo, and live TV libraries and streams them to smart TVs, stream…
- Infuse - Ignite your video content with Infuse – the beautiful way to watch almost any video format on your iPhone, iPad, and Apple TV.
- Jellyfin - Jellyfin is a Free Software Media System that puts you in control of managing and streaming your media.
- Kodi - Kodi is a free, open-source media center and player that organizes and plays movies, shows, music, and photos on TVs, computers, and mobile…
- MediaChips - MediaChips is a desktop app for organizing local media libraries.
- Music Assistant - Music Assistant is a self-hosted, open-source music library manager for Home Assistant.
- OSMC - OSMC (Open Source Media Center) is a free and open source media player based on Linux and founded in 2014 that lets you play back media fro…
- Plex - Plex is a LinuxServer.io Docker container that runs Plex Media Server so home users can organize and stream personal video, music, and phot…
- Rygel - Rygel is a home media server for Linux that shares your audio, video, and pictures across your local network.
Checked 40 days ago - source: AlternativeTo
Common questions
Should I stop Plex before running Plex DBRepair?
Yes. Stop the Plex container or process before the repair, and if using the Docker helper variables it can use the Docker socket to stop and restart Plex.
Which folder do I need to mount into the Plex DBRepair container?
Mount the parent Plex appdata directory to /config, not the Library folder itself. It must contain the Plex nested folders, including Library/Application Support/Plex Media Server.
Does Plex DBRepair need exposed ports or network access?
No. The container does not need a network.
Do I need to back up my database first?
Yes. The container modifies the Plex SQLite database directly, so you should have verified, working backups before proceeding.
Is Plex DBRepair safe for the latest Plex database schema?
The project warns that it is not meant to be run on the latest Plex SQL changes to FTS.
Answers sourced from github.com
Community
- DBRepair failure on Windows - Plex Media Server - Plex Forum (forum)
- Plex Databases corrupted constantly (forum)
- Database is corrupt or Maintenance? - Plex Forum (forum)
- How to run PlexDBRepair : r/unRAID - Reddit (reddit)
- Plex DB Repair Help : r/PleX - Reddit (reddit)
Collected 48 days ago - public community threads