Synology_Plex_Backup

KO | EN

gitlite — search

#react #llm #golang #machine-learning #rust #linux #macos #java #windows #awesome #kubernetes #security #pytorch #ios

Synology_Plex_Backup

(★ 45)

A script to backup Plex to a tgz file. For DSM 7 and DSM 6.

Synology_Plex_Backup Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Synology Plex Backup

<a href="https://github.com/007revad/Synology_Plex_Backup/releases"><img src="https://img.shields.io/github/release/007revad/Synology_Plex_Backup.svg"></a>
![Badge](https://hitscounter.dev/api/hit?url=https%3A%2F%2Fgithub.com%2F007revad%2FSynology_Plex_Backup&label=Visitors&icon=github&color=%23198754&message=&style=flat&tz=Australia%2FSydney)
[![Donate](https://img.shields.io/badge/Donate-PayPal-green.svg)](https://www.paypal.com/paypalme/007revad)
[![](https://img.shields.io/static/v1?label=Sponsor&message=%E2%9D%A4&logo=GitHub&color=%23fe8e86)](https://github.com/sponsors/007revad)

### Description

This is a bash script to backup a Synology's Plex Media Server settings and database, and log the results.

-  Works for Plex installed from Package Center and in Docker.
-  The script works in DSM 7 and DSM 6.

#### What the script does:

-   Gets your Synology's hostname and model (for use in the backup filename and log name).
-   Checks that the script is running as root.
-   Checks it is running on a Synology.
-   Gets Plex Media Server's version (for the backup filename and log).
-   Gets the volume and share name where Plex Media Server's database is located.
-   Checks that your specified backup location exists.
-   Stops Plex Media Server, then checks Plex actually stopped.
-   Backs up Plex Media Server to a tgz file (**excluding the folders listed in plex_backup_exclude.txt**).
-   Starts Plex Media Server.
-   Optionally adds an entry to the Synology's system log stating if the backup succeded or failed.
-   Optionally sends a notification to DSM if Plex Backup completed, or had errors (**only works in DSM 6 for now**).

#### It also saves a log in the same location as the backup file, including:

-   Logging the start and end time plus how long the backup took.
-   Logging every file that was backed up (can be disabled).
-   Logging any errors to a separate error log file to make it easy for you to see if there were errors.

The Synology's hostname, date, and Plex Media Server version are included in the backup's filename in case you need to roll Plex back to an older version or you save backups from more than one Plex Server.

**Example of the backup's auto-generated filenames:** 
-   DISKSTATION_20221025_Plex_1.29.0.6244_Backup.tgz
-   DISKSTATION_20221025_Plex_1.29.0.6244_Backup.log
-   DISKSTATION_20221025_Plex_1.29.0.6244_Backup_ERROR.log (**only if there was an error**)

If you run multiple backups on the same day the time will be included in the filename.

**Example of the backup's auto-generated filenames when run more than once on the same day:** 
-   DISKSTATION_20221025_1920_Plex_1.29.0.6244_Backup.tgz
-   DISKSTATION_20221025_1920_Plex_1.29.0.6244_Backup.log

### Download the script

1. Download the latest version _Source code (zip)_ from https://github.com/007revad/Synology_Plex_Backup/releases
2. Save the download zip file to a folder on the Synology.
3. Unzip the zip file.

### Settings

You need to set **backupDirectory=** near the top of the script (below the header). Set it to the location where you want the backup saved to.

**For example:**

```YAML
backupDirectory="/volume1/Backups/Plex_Backups"
```

**For Docker there are few more settings required:**

```YAML
# Backup docker Plex instead of package center Plex
Docker="yes"
# Path to Plex container's 'Application Support' folder
Docker_plex_path="/volume1/docker/plex/Library/Application Support"
# Plex container name
Docker_plex_name="plexinc-pms-docker-1"
```

**There are also a few optional settings:**

The script gets the brand, model and hostname from the NAS to use logs and backup name.
Set Name= to "brand", "model", "hostname" or some nickname. If Name= is blank the Synology's hostname will be used.

```YAML
Name="brand"
```

Log all files backed up. If enabled all files added to the tgz archive will be logged.
Set LogAll= to "yes" or "no". Blank is the same as no.

```YAML
LogAll="no"
```

Add Plex backup success or Plex backup failed entry to DSM system log.
Set SysLog= to "yes" or "no". Blank is the same as no.

```YAML
SysLog="yes"
```

Add success or failed entry to DSM notifications.
Set Notify= to "yes" or "no". Blank is the same as no.

```YAML
Notify="yes"
```

### Requirements

Make sure that plex_backup_exclude.txt is in the same folder as backup_synology_plex_to_tar.sh

**Note:** Due to some of the commands used **this script needs to be run as root, or be scheduled to run as root**.

### Testing the script

If you run the script with the **test** argument it will only backup Plex's Logs folder.

```YAML
"/volume1/scripts/Backup_Plex_on_Synology.sh" test
```

If you run the script with the **error** argument it will only backup Plex's Logs folder and cause an error so you can test the error logging.

```YAML
"/volume1/scripts/Backup_Plex_on_Synology.sh" error
```

### Restoring a backup

To restore Plex from a backup run the following in a shell:

**Note:** Replace "/path/file.tgz" with your backup file's path and filename. Replace the 1 in volume1 with your volume number.

For DSM 7
```YAML
tar -zxvpf /path/file.tgz -C "/volume1/PlexMediaServer/AppData/"
```

For DSM 6
```YAML
tar -zxvpf /path/file.tgz -C "/volume1/Plex/Library/Application Support/"
```

Synology_Plex_Backup

Synology_Plex_Backup Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Synology_Plex_Backup

Synology_Plex_Backup Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README