PlexDBRepair/README.md

DBRepair (for Plex Media Server)

DBREPAIR IS BACK!

DBRepair has been completely rewritten from scratch for all supported platforms as a free-standing, no external dependencies, executable program.

🎉 Windows Users: Beginning with DBRepair 26.10.00, Windows is fully supported via a native, standalone DBRepair.exe executable! Previous versions of DBRepair required separate .bat or .ps1 scripts, have now been completely obsoleted. Just download, extract, and run.

DBRepair is run from a command line (terminal, Command Prompt/PowerShell, or ssh/putty session) on the local host machine. It must have sufficient privileges to read/write the databases. Because DBRepair is distributed as a compiled executable, it requires no external runtime dependencies.

If sufficient privileges exist (root/Administrator), and are supported by the environment, the options to start and stop PMS are presented as well.

Documentation

Full documentation (installation, every menu command, typical usage, command-line options, environment variables, supported hosts) is on the DBRepair Wiki.

• Install
• Typical Usage
• Command-Line Options
• Supported Hosts
• Support

For a complete list of commands in the menu, see: Menu

Situations and errors commonly seen include:

1. Searching is sluggish or broken
2. Database is malformed / damaged / corrupted
3. Database has bloated from media addition or changes
4. Damaged indexes / Rows out of order
5. Tables, Indexes, or other items missing from databases (seen in logs)
6. Importing data from other databases (watch history)
7. Cleaning up operational temp files which PMS has forgotten
8. Other maintenance and checks to keep your server running optimally

Getting Started

Downloading

Available Packages

DBRepair is packaged as a .zip archive for easy downloading. Each archive contains the standalone executable for the target platform, along with the README.md, ReleaseNotes, and License.md files.

The following architectures are supported:

• MacOS - Arm64
• MacOS - X86_64
• Linux - Arm32 (armv7)
• Linux - Arm64 (armv8)
• Linux - X86_64
• Windows - X86_64

It is highly recommended to download the packaged .zip archive for your system.

Navigate to the latest release: DBRepair Latest Release and download the appropriate .zip file for your platform from the Assets section.

(Advanced users: Raw binaries are also available in the release assets if you prefer to download only the executable without the bundled documentation).

Where to install DBRepair