Backing up your Plex server configuration protects the hours you have spent organising libraries, tagging metadata, setting up users, and fine-tuning playback settings. This guide walks you through exactly what to copy, how to do it safely without corrupting the database, and how to restore everything if you move to a new machine or recover from a failure. It suits anyone running Plex on Windows, Mac, Linux, or a NAS device.
Table of Contents
What you’ll need
- Administrator access to the computer or device running Plex Media Server
- An external drive, network share, or cloud storage location to hold the backup files
- A few minutes of downtime while Plex is stopped during the copy process
- Enough free storage space, since the configuration folder can grow large over time due to cached artwork and metadata
Understanding what actually needs backing up
Plex keeps almost everything important in a single application data folder, often referred to as the “Plex Media Server” data directory. This is separate from your actual media files (movies, shows, and music), which stay in whatever folders you pointed Plex to when you set things up. If you followed a guide on setting up a Plex Media Server, this data folder was created automatically during installation.
Inside that folder, the parts that matter most for a configuration backup are the main database files, your preferences file, and any custom metadata agents or plugins you have installed. The database stores your library structure, watch history, user accounts, collections, and playlists. The preferences file stores server-wide settings such as remote access, transcoding options, and library paths. Losing these means rebuilding your entire setup from scratch, even if your media files are untouched.
Step 1: Locate your Plex data folder
- Open the folder where Plex stores its application data. On Windows this is typically found under your user’s local application data area, inside a folder named for Plex Media Server. On a Mac it sits inside your user Library folder under Application Support. On Linux or NAS installs, the location depends on how Plex was installed, so check your specific platform’s documentation if you are unsure.
- Confirm you can see subfolders such as one holding the databases and plugin support files, along with a preferences file. If you can see these, you have found the correct folder.
Step 2: Stop the Plex Media Server before copying anything
- Open the Plex server settings and shut down the Plex Media Server service or application completely. Copying files while Plex is actively writing to the database risks creating a corrupted or incomplete backup.
- Wait a few moments to make sure the background process has fully stopped before continuing. On some systems you can check this through the task manager, activity monitor, or service manager.
Step 3: Copy the configuration folder to a safe location
- Copy the entire Plex Media Server data folder to your chosen backup location, whether that is an external drive, a network share, or a cloud sync folder.
- If the full folder is too large due to cached images and metadata, prioritise copying the folder containing your databases and the main preferences file, since these hold the settings and library structure that are hardest to recreate manually.
- Rename the backup folder to include the date, so you can easily identify which version is most recent if you build up several backups over time.
Step 4: Restart Plex and confirm it still works
- Start the Plex Media Server again once the copy has finished.
- Open the Plex app and check that your libraries, watch history, and settings all appear as expected. This confirms the server is running normally and that your backup was taken from a healthy, working state.
Using Plex’s built-in database backup option
Plex includes a scheduled task that can automatically back up the database on a regular basis. It is worth enabling this alongside your manual folder backups, since it creates rolling copies of the database without you needing to stop the server each time. Check the scheduled tasks section within your server settings to turn this on and choose how many backup copies to retain. This does not replace a full folder backup, since it only covers the database rather than plugins or advanced preferences, but it adds a useful extra layer of protection between manual backups.
Restoring your configuration
- Install Plex Media Server on the new or repaired machine using the official Plex Media Server installer.
- Stop the freshly installed Plex service before making any changes.
- Replace the newly created, empty data folder with your backed-up version, matching the folder structure exactly.
- Start Plex again and give it a few minutes to detect the restored database and rebuild any missing caches.
- Once running, check your libraries load correctly. You may need to refresh your Plex library if any media paths have changed on the new system.
Tips and troubleshooting
- Always stop Plex before copying files. Backing up a live database is the most common cause of corrupted restores.
- Keep at least two backup copies from different dates in case a recent backup turns out to be incomplete.
- If your media library paths change when restoring to a new machine, you may need to update library locations manually, or work through steps to fix Plex server connection issues if the server does not come back online properly.
- For servers with large libraries, consider excluding cached image thumbnails from your backup to save space, since Plex will regenerate these over time.
- If you regularly reorganise content, review your setup for managing multiple Plex libraries so your backup structure matches how your content is actually organised.
Frequently asked questions
Do I need to back up my actual media files too?
Not as part of this process. Media files like movies and shows are stored separately from the Plex configuration, so back those up through your normal file or NAS backup routine rather than alongside the server settings.
How often should I back up my Plex configuration?
A monthly backup is reasonable for most home setups, though you should always take a fresh backup before any major change, such as upgrading hardware, moving to a new operating system, or making significant library restructuring.
Can I move a backup between different operating systems?
Generally yes, since the database format is consistent across platforms, but file paths for your media may differ between systems. Expect to update library locations after restoring onto a different operating system.
What happens if I skip stopping the server before backing up?
You risk copying a database file mid-write, which can lead to a corrupted or unreadable backup. Always shut down Plex Media Server fully before copying any configuration files.
