Install

This tool does not need to be installed in any way, since it's a simple portable one file tool

Simply download the version that matches your operating system here:

Latest Release

After that is done, open a terminal/command line and execute the downloaded file

Note: If running on Linux or Mac, you might have to set the execute flag on the file after downloading it, so in the terminal window type:

chmod +x <NAME_OF_THE_DOWNLOADED_FILE>

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:

• Linux (ARM 32-bit): DBRepair-<version>-Linux-arm32.zip
• Linux (ARM 64-bit): DBRepair-<version>-Linux-arm64.zip
• Linux (Intel 64-bit): DBRepair-<version>-Linux-x86_64.zip
• macOS (Apple Silicon): DBRepair-<version>-MacOS-arm64.zip
• macOS (Intel): DBRepair-<version>-MacOS-x86_64.zip
• Windows (64-bit): DBRepair-<version>-Windows-x86_64.zip

It is highly recommended to download the packaged .zip archive for your system. Navigate to the 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 place the utility

Where to extract and place the utility varies from host to host. Please use this table as a reference for where to put the extracted files.

Some hosts will not be listed here by name (e.g. Unraid, Proxmox). They will likely be supported by the container/VM Plex Media Server runs in.

Vendor             | Shared folder name  |  Recommended directory
-------------------+---------------------+-----------------------------------
Apple              | Downloads           |  ~/Downloads
Arch Linux         | N/A                 |  Anywhere
ASUSTOR            | Plex                |  /volume1/Plex
Binhex             | N/A                 |  Container root (adjacent /config)
Docker (Plex,LSIO) | N/A                 |  Container root (adjacent /config)
Hotio              | N/A                 |  Container root (adjacent /config)
Kubernetes         | N/A                 |  Container root (adjacent /config)
Linux (wkstn/svr)  | N/A                 |  Anywhere
MacOS              | N/A                 |  Anywhere
Netgear (ReadyNAS) | "your_choice"       |  "/data/your_choice"
QNAP (QTS/QuTS)    | Public              |  /share/Public
SNAP               | N/A                 |  Anywhere
Synology (DSM 6)   | Plex                |  /volume?/Plex
Synology (DSM 7)   | PlexMediaServer     |  /volume?/PlexMediaServer
Western Digital    | Public              |  /mnt/HD/HD_a2/Public
  (Does not support 'MyCloud Home' series)
Windows            | Downloads           |  C:\Users\YourName\Downloads

FreeBSD (14+)      | N/A                 |  Not Yet Available

• Plex, Inc. and LSIO docker images are included in the "Docker" platform category independent of the actual host.
• Additional hosts and docker images can easily be supported in almost all cases with appropriate path information. Please contact me as needed.

Opening a session

1. Windows
   • Open a Command window (cmd.exe or PowerShell).
   • Right-click and "Run as Administrator" if required.
2. Linux
   • Open a terminal session and elevate to the root (sudo) user.
3. Accessing a NAS
   • Open a terminal/command line window on your computer.
   • Type: ssh admin-username@IP.addr.of.NAS

Extract and run

Linux

1. Download DBRepair-<version>-Linux-<arch>.zip from the latest release, where <arch> is arm32, arm64 or x86_64.
2. Extract it to the folder recommended above.
3. In a terminal, elevate to root (sudo) if needed, cd to that folder, run chmod +x DBRepair, then ./DBRepair.

macOS

1. Download DBRepair-<version>-MacOS-arm64.zip (Apple Silicon) or DBRepair-<version>-MacOS-x86_64.zip (Intel) from the latest release.
2. Extract it to the folder recommended above.
3. In Terminal, cd to that folder, run chmod +x DBRepair, then ./DBRepair. If macOS blocks it, see "macOS: Quarantined downloads" below.

Windows

1. Download DBRepair-<version>-Windows-x86_64.zip from the latest release.
2. Unzip it to the folder recommended above, then run DBRepair.exe as Administrator. Use whichever method you prefer:

File Explorer

Right-click the downloaded zip and choose Extract All... to unzip it. Then right-click DBRepair.exe in the extracted folder and choose Run as Administrator.

PowerShell (as Administrator)

cd C:\Users\YourName\Downloads
Expand-Archive -Path DBRepair-<version>-Windows-x86_64.zip -DestinationPath .\DBRepair
cd .\DBRepair
.\DBRepair.exe

cmd.exe (as Administrator)

cd C:\Users\YourName\Downloads
unzip DBRepair-<version>-Windows-x86_64.zip
DBRepair.exe

macOS: Quarantined downloads

macOS quarantines every file downloaded from the internet, and will not run the utility until the quarantine is cleared. Use either method.

Method 1 - Without Terminal commands (once per download)

1. Try to open DBRepair. When macOS blocks it, click Done.
2. Open System Settings, then Privacy & Security.
3. Scroll down to Security and click Open Anyway.
4. Click Open to confirm.

Method 2 - Terminal (removes the quarantine permanently)

xattr -d com.apple.quarantine DBRepair

References

• Apple Support, "Safely open apps on your Mac": https://support.apple.com/en-us/102445
• xattr command: type man xattr in Terminal

Windows: Blocked downloads

Windows marks every file downloaded from the internet as blocked. Use either method.

Method 1 - File Explorer (once per file)

1. Right-click DBRepair.exe and choose Properties.
2. Select Unblock, then click OK.

Method 2 - PowerShell

Unblock-File .\DBRepair.exe

References

• Microsoft Learn, "Unblock-File": https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.utility/unblock-file

Examples

To install & launch on Windows

See "Extract and run" - "Windows" above for File Explorer, PowerShell and cmd.exe.

To install & launch on Synology DSM 6 / DSM 7

cd /volume1/Plex    # use /volume1/PlexMediaServer on DSM 7
sudo bash
unzip DBRepair-<version>-Linux-x86_64.zip
chmod +x DBRepair
./DBRepair

Using DBRepair inside containers (manual start/stop included)

Select containers allow stopping/starting Plex Media Server from the menu. See the menu for details.

sudo docker exec -it plex /bin/bash

# Download, extract, and run
# Example assumes you have wget installed in the container
wget https://github.com/ChuckPa/DBRepair/releases/download/<version>/DBRepair-<version>-Linux-x86_64.zip
unzip DBRepair-<version>-Linux-x86_64.zip
chmod +x DBRepair
./DBRepair

Using DBRepair on a regular Linux native host (Workstation/Server)

sudo bash
cd /path/to/download/directory
unzip DBRepair-<version>-Linux-x86_64.zip
chmod +x DBRepair
./DBRepair auto exit

Using DBRepair from the command line on macOS (on the administrator account)

osascript -e 'quit app "Plex Media Server"'
cd ~/Downloads
unzip DBRepair-<version>-MacOS-arm64.zip  # Or -x86_64 depending on Mac processor
chmod +x DBRepair
xattr -d com.apple.quarantine DBRepair
./DBRepair

---

Back | Next