KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#typescript #ai-agents #cli #open-source #ai #claude-code #codex #developer-tools #react #windows #deepseek-harness #ai-agent

Linux_Plex_Backup

★ 44 Open GitHub ↗

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

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Linux Plex Backup

<a href="https://github.com/007revad/Linux_Plex_Backup/releases"><img src="https://img.shields.io/github/release/007revad/Linux_Plex_Backup.svg"></a>
![Badge](https://hitscounter.dev/api/hit?url=https%3A%2F%2Fgithub.com%2F007revad%2FLinux_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 Linux Plex Media Server settings and database, and log the results.

#### What the script does:

-   Gets your Linux computer's hostname and distro name (for use in the backup filename and log name).
-   Checks that the script is running with the required privileges.
-   Gets Plex Media Server's version (for the backup filename and log).
-   Checks 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.
-   Emails the log to your email address (optional). Use when you have scheduled the script.

#### 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 in config file).
-   Logging any errors to a separate error log file to make it easy for you to see if there were errors.

The Linux computer'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 Servers.

**Example of the backup's auto-generated filenames:** 
-   ubuntu_20221025_Plex_1.29.0.6244_Backup.tgz
-   ubuntu_20221025_Plex_1.29.0.6244_Backup.log
-   ubuntu_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:** 
-   ubuntu_20221025_1920_Plex_1.29.0.6244_Backup.tgz
-   ubuntu_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/Linux_Plex_Backup/releases
2. Save the download zip file to a folder on the Linux computer.
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.

```YAML
Backup_Directory=/share/Backups/Plex_Backups
```
or
```YAML
Backup_Directory=/share/folder with spaces/Plex_Backups
```

The script gets the disto and hostname from the NAS to use logs and backup name.
Set Name= to distro, hostname or you can set a 'nickname'. If Name= is blank the Linux computer's hostname will be used.

The LogAll setting enables, or disables, logging every file that gets backed up. Set LogAll= to yes or no. Blank is the same as no.

If to_email_address and from_email_address are set an email containing the log will be sent after the script finishes.

```YAML
to_email_address=email@email.com
from_email_address=email@email.com
```

The KeepQty setting tells the script to keep only keep the latest N backups (and delete older backups).
  - If KeepQty is blank or set to 0 all backups are kept.

```YAML
Name=distro
LogAll=no
KeepQty=5
```

### Requirements

Make sure that backup_linux_plex.config and plex_backup_exclude.txt are in the same folder as Linux_Plex_Backup.sh

**Note:** Due to some of the commands used **this script needs to be** run by a user in sudo, sudoers or wheel group, or as root

If you want the script to send an email of the log after the script finishes you need to have msmtp installed (most Linux distros include msmtp).

### Configuring msmtp so the script can send emails

Depending on your Linux distro the msmtprc or config file can be either:
```
    /etc/msmtprc
    ~/.msmtprc
    $XDG_CONFIG_HOME/msmtp/config
```

The default msmtprc or config file usually contains:
```
# Set default values for all following accounts.
defaults
timeout 15
tls on
tls_trust_file /usr/builtin/etc/msmtp/ca-certificates.crt
#logfile ~/.msmtplog

# The SMTP server of the provider.
#account user@gmail.com
#host smtp.gmail.com
#port 587
#from user@gmail.com
#auth on
#user user@gmail.com
#password passwd

# Set a default account
#account default: user@gmail.com
```

**Example email account settings for using a smtp server**
```
defaults
timeout 15
tls on
tls_trust_file /usr/builtin/etc/msmtp/ca-certificates.crt
#logfile ~/.msmtplog

# The SMTP server of the provider.
account dave@myisp.com
host mail.myisp.com
port 587
from dave@myisp.com
auth on
user dave@myisp.com
password mypassword

# Set a default account
account default: dave@myisp.com
```

If you don't want to include your email account's password in plain text in the msmtprc or config file see https://marlam.de/msmtp/msmtprc.txt

**Example email account settings for using gmail**
```
# Set default values for all following accounts.
defaults
timeout 15
tls on
tls_trust_file /usr/builtin/etc/msmtp/ca-certificates.crt
#logfile ~/.msmtplog

# The SMTP server of the provider.
account dave@gmail.com
host smtp.gmail.com
port 587
from dave@gmail.com
auth on
user dave@gmail.com
password gmailapppassword

# Set a default account
account default: dave@gmail.com
```

For gmail you will need to generate an "app password" and use that instead of your gmail password.

1. Go to https://myaccount.google.com/apppasswords and sign into google.
2. Enter a name in the form of `appname@computer-name` like `plexbackup@ubuntu` and click Create.
3. In the "Generated app password" popup copy the 16 character app password which will be like `abcd efgh ijkl mnop`
4. In your msmtprc or config file replace `password passwd` with the 16 character app password (without spaces) like:
```
password abcdefghijklmnop
```

### Running the script

Run the script by a user in sudo, sudoers or wheel group.

```YAML
sudo -s "/share/scripts/Linux_Plex_Backup.sh"
```

### Running automatically with systemd

If you prefer to run the backup automatically with systemd timers instead of cron, you can use these example unit files.

Create the service unit at `/etc/systemd/system/linux_plex_backup.service`:

```ini
[Unit]
Description=Linux Plex Backup

[Service]
Type=oneshot
ExecStart=/share/scripts/Linux_Plex_Backup.sh

[Install]
WantedBy=multi-user.target

```
**Note:** Replace "/share/scripts/" with the path to where Linux Plex Backup's files are located.

Then create the timer unit at /etc/systemd/system/linux_plex_backup.timer:

```
[Unit]
Description=Run Linux Plex Backup once a day

[Timer]
OnCalendar=*-*-* 03:00
Persistent=true

[Install]
WantedBy=timers.target
```
After creating both files, reload systemd and start the timer:

```
sudo systemctl daemon-reload
sudo systemctl enable --now linux_plex_backup.timer
```
Adjust /share/scripts/Linux_Plex_Backup.sh and the OnCalendar time to match your actual script path and preferred backup schedule.

### Troubleshooting

| Issue | Cause | Solution |
|-------|-------|----------|
| /usr/bin/env: ‘bash\r’: No such file or directory | File has Mac line endings! | [Download latest zip file](https://github.com/007revad/Linux_Plex_Backup/releases) |
| Cursor sits there doing nothing | File has Windows line endings! | [Download latest zip file](https://github.com/007revad/Linux_Plex_Backup/releases) |
| syntax error near unexpected token | You downloaded the webpage! | [Download latest zip file](https://github.com/007revad/Linux_Plex_Backup/releases) |

If you get a "No such file or directory" error check the following:

1. Make sure you unpacked the zip or rar file that you downloaded and are trying to run the Linux_Plex_Backup.sh file.
2. If the path to the script contains any spaces you need to enclose the path/scriptname in double quotes:
   ```YAML
   sudo -s "/share/folder with spaces/Linux_Plex_Backup.sh"
   ```
3. Set the script files as executable:
   ```YAML
   sudo chmod +x "/share/scripts/Linux_Plex_Backup.sh"
   sudo chmod +x "/share/scripts/Restore_Linux_Plex_Backup.sh"
   ```

### Testing the script

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

```YAML
sudo -s "/share/scripts/Linux_Plex_Backup.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
sudo -s "/share/scripts/Linux_Plex_Backup.sh" error
```

### Restoring from a backup

To restore Plex from a backup run the included Restore_Linux_Plex_Backup.sh in a shell:

```YAML
sudo -s "/share/scripts/Restore_Linux_Plex_Backup.sh"
```

**Note:** Replace "/share/scripts/" with the path to where Linux Plex Backup's files are located.

The first thing you'll see is a menu listing all of your Plex backups that you created with Linux Plex Backup. Select the backup you want to restore and the script will do the rest.

**Note:** I would only restore a backup from the same Plex version as you currently have installed (which is why the Plex version is included in the backup file name and logs.

### Restoring a test backup

If you previously ran Linux Plex Backup with the **test** argument you can run Restore_Linux_Plex_Backup.sh with the **test** argument so the menu will list any small backups (less than 1 MiB).

```YAML
sudo -s "/share/scripts/Restore_Linux_Plex_Backup.sh" test
```

Linux_Plex_Backup

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README