mirror of
https://github.com/ChuckPa/PlexDBRepair.git
synced 2026-10-17 08:53:23 -05:00
83 lines
4.5 KiB
Markdown
83 lines
4.5 KiB
Markdown
# DBRepair (for Plex Media Server)
|
|
|
|
[](https://github.com/ChuckPa/DBRepair/issues)
|
|
[](https://github.com/ChuckPa/DBRepair/releases/latest)
|
|
[](https://github.com/ChuckPa/DBRepair/releases/latest)
|
|
[](https://github.com/ChuckPa/DBRepair/releases)
|
|
[](https://github.com/ChuckPa/DBRepair/tree/main)
|
|
|
|
[](https://github.com/sponsors/ChuckPa)
|
|
|
|
|
|
## 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](https://github.com/ChuckPa/DBRepair/wiki).
|
|
|
|
* [Install](https://github.com/ChuckPa/DBRepair/wiki/Install)
|
|
* [Typical Usage](https://github.com/ChuckPa/DBRepair/wiki/Typical-Usage)
|
|
* [Command-Line Options](https://github.com/ChuckPa/DBRepair/wiki/Command-Line-Options)
|
|
* [Supported Hosts](https://github.com/ChuckPa/DBRepair/wiki/Supported-Hosts)
|
|
* [Support](https://github.com/ChuckPa/DBRepair/wiki/Support)
|
|
|
|
For a complete list of commands in the menu, see: [Menu](https://github.com/ChuckPa/DBRepair/wiki/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](https://github.com/ChuckPa/DBRepair/releases/latest/download/DBRepair-26.10.00-MacOS-arm64.zip)
|
|
* [MacOS - X86_64](https://github.com/ChuckPa/DBRepair/releases/latest/download/DBRepair-26.10.00-MacOS-x86_64.zip)
|
|
* [Linux - Arm32 (armv7)](https://github.com/ChuckPa/DBRepair/releases/latest/download/DBRepair-26.10.00-Linux-arm32.zip)
|
|
* [Linux - Arm64 (armv8)](https://github.com/ChuckPa/DBRepair/releases/latest/download/DBRepair-26.10.00-Linux-arm64.zip)
|
|
* [Linux - X86_64](https://github.com/ChuckPa/DBRepair/releases/latest/download/DBRepair-26.10.00-Linux-x86_64.zip)
|
|
* [Windows - X86_64](https://github.com/ChuckPa/DBRepair/releases/latest/download/DBRepair-26.10.00-Windows-x86_64.zip)
|
|
|
|
It is highly recommended to download the packaged `.zip` archive for your system.
|
|
|
|
Navigate to the latest release:
|
|
[DBRepair Latest Release](https://github.com/ChuckPa/DBRepair/releases/latest)
|
|
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](https://github.com/ChuckPa/DBRepair/wiki/Install)
|