plex-dbrepair

Overview

You must mount your Plex container's appdata folder into this container. Example: /mnt/user/appdata/plex Inside this folder you should see the directory structure: Library/Application Support/Plex Media Server Do NOT mount the Library folder itself. Mount the parent Plex appdata directory. The script runs once automatically and repairs the Plex database, then the container exits. No Plex container or Plex process should be running during repair. Check container logs to monitor progress. You may also open the console and run "top" to verify activity.

Requirements

YOU ARE ULTIMATELY RESPONSIBLE FOR YOUR DATA. PLEX MUST BE STOPPED BEFORE RUNNING THIS TOOL. Mount your Plex appdata folder into this container.

Runtime arguments

Network: bridge
Shell: bash
Privileged: false
Extra Params: --hostname dbrepair

Template configuration

Plex Appdata FolderPathrw

THE OTHER CONTAINERS APPDATA FOLDER!!! The Path to your Plex container appdata folder (the folder that CONTAINS the 'Other Plex Containers Library' directory). Example: /mnt/user/appdata/plex. Inside this folder, you should see 'Library'. Do NOT mount the Library folder itself!

Target: /config
Default: /mnt/user/appdata/plex_Supply_the_Plex_appdata_folder_here
Value: /mnt/user/appdata/plex_Supply_the_Plex_appdata_folder_here

DBREPAIR_MODEVariable

automatic (check, vacuum, reindex) · check (integrity check only) · vacuum (optimize database) · repair (alias for vacuum) · reindex (rebuild indexes) · deflate (VACUUM INTO rewrite) · prune (clear PhotoTranscoder cache)

Default: automatic
Value: automatic

ALLOW_PLEX_KILLVariable

T/F If enabled, the container will stop running Plex containers before database operations begin. Requires /var/run/docker.sock.

Default: true
Value: true

PLEX_CONTAINER_MATCHVariable

Pattern used to identify Plex containers to stop by name or image.

Default: plex
Value: plex

RESTART_PLEXVariable

T/F Restart Plex containers after repairs complete.

Default: true
Value: true

PRUNE_DAYSVariable

Files older than this number of days will be removed from the PhotoTranscoder cache when using DBREPAIR_MODE=prune.

Default: 30
Value: 30

ENABLE_BACKUPSVariable

T/F Create timestamped database backups before any changes.

Default: true
Value: false

RESTORE_LAST_BACKUPVariable

T/F Restore most recent backup and exit.

Default: false
Value: false

EXCLUDE_CONTAINER_NAMESVariable

CSV list of containers that should never be stopped.

Default: dbrepair,plex-dbrepair
Value: dbrepair,plex-dbrepair

EXCLUDE_IMAGE_REGEXVariable

Image regex used to avoid stopping the dbrepair container itself.

Default: plex-dbrepair
Value: plex-dbrepair

Docker Run SocketPathrw

Required to manage Plex containers from Unraid.

Target: /var/run/docker.sock
Default: /var/run/docker.sock
Value: /var/run/docker.sock

Links

Template Support Docker Hub Project

Details

Repository

bmmbmm01/plex-dbrepair

Registry

https://hub.docker.com/r/bmmbmm01/plex-dbrepair

Last Updated2026-01-13

First Seen2026-01-11

Run plex-dbrepair on Unraid.

plex-dbrepair is listed in Community Apps for Unraid OS. Explore Unraid to build a flexible home server, NAS, or homelab.

Explore Unraid OS