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…

  • Media Applications
  • Tools & Utilities
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 database. At startup it downloads the latest DBRepair build for the machine's architecture, you mount the Plex appdata folder, the repair runs once, and the container exits. It is aimed at homelab users troubleshooting Plex database problems, and you should stop Plex and keep a verified backup before running it, since the tool modifies the SQLite database directly. Avoid it on Plex 1.43.0 and later, where Plex changed its FTS SQL schema. Note: the project's GitHub repository has been archived, so no further updates are expected.

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

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

Collected 48 days ago - public community threads