This script addresses common issues with automatically updating Plex on Synology NAS, evolved significantly from the original "martinorob/plexupdate" script. It has been overhauled to eliminate the need for Bash variable editing or SSH access, making it user-friendly for DSM web administration. The original fork from "martinorob/plexupdate" has been discontinued due because the current script was rewritten from the ground up with extensive modifications, resulting in a unique script with different support requirements.
The script is tailored specifically to update the official Synology package of Plex Media Server, as released by Plex GmbH. It uses Synology's built-in tools to automatically detect Plex's installation location, manage updates, and notify the system of any issues. If Plex is properly installed, no manual script editing is needed. The script respects the update channel settings (Public or Beta) configured in your Plex Media Server's 'General' settings.
Though primarily developed and tested on and against a DS1019+, the script is designed and written to work on any compatible Synology platform using DSM's command-line utilities. It reads the local hardware architecture and ensures compatibility with specific versions of Plex that are released for specific Synology hardware platforms. If the update is part of the official Plex public or beta channel, the script will apply it.
By default, the script only installs updates that are at least 7 days old, serving as a stability measure. Additionally, it retains previously downloaded and installed packages in an "Updates" archive for 60 days before automatic deletion to make rollbacks easier to find and perform.
DSM 7 is officially supported starting from v4.0.0 and the OS platform that the script is developed for. DSM 6 support culminated with the v3.x.x series of the script. Dual support may be considered in the future, but it is not at this time while the code is optimized and stablized for DSM 7, and after some new features are implimented. I welcome development collaboration if anyone is interested, but I do not use DSM 6 myself, so it makes my own work in this direction difficult and undesirable.
Download the script and place it into a location of your choosing. As an example, if you are using the "admin
" account for system administration tasks, you can place the script within that accounts home folder; such as in a nested directory location like this:
/home/scripts/bash/plex/syno.plexupdate/syno.plexupdate.sh
-or-
/homes/admin/scripts/bash/plex/syno.plexupdate/syno.plexupdate.sh
Note: Synology recommends that you disable the default "admin
" account for security reasons. In these examples, the admin directory structure is just a script storage location. You can run the script from here even if you disable the "admin
" account (which you really should).
Updates directly from Plex (which is what this script installs) are not installable in the Synology DSM 6 by default - because no 3rd-party applications are. To install updates directly from Plex, DSM 6 must be configured to allow packages from other trusted application publishers. To facilitate this, Plex's 'Public Key Certificate' must be installed to allow this securely and without simply allowing any and all application publishers to be installable. The full instructions for this can be found on Plex's website here:
Syno.Plex Update
', and leave User: set to 'root
'bash /volume1/homes/admin/scripts/bash/plex/syno.plexupdate/syno.plexupdate.sh
'/volume1
' is the default storage volume on a Synology NAS. You can determine your script directory's full pathname by looking at the Location properties of the folder with the File Station tool in the DSM:
The script will automatically create directories and files as needed in the following directory structure based off of the location of the script, as per this example:
/volume1/homes/admin/scripts/bash/plex/syno.plexupdate
| config.ini
| README.md
| syno.plexupdate.sh
|
\---Archive
+---Packages
| changelog.txt
| PlexMediaServer-1.21.3.4021-5a0a3e4b2-x86_64.spk
| PlexMediaServer-1.21.3.4046-3c1c83ba4-x86_64.spk
| PlexMediaServer-1.21.4.4079-1b7748a7b-x86_64.spk
| PlexMediaServer-1.22.0.4163-d8c4875dd-x86_64.spk
| PlexMediaServer-1.22.1.4228-724c56e62-x86_64_DSM6.spk
| PlexMediaServer-1.22.2.4256-1e171f908-x86_64_DSM6.spk
| ...
|
\---Scripts
syno.plexupdate.v2.3.1.sh
syno.plexupdate.v2.3.2.sh
syno.plexupdate.v2.3.3.sh
syno.plexupdate.v2.9.9.sh
syno.plexupdate.v2.9.9.1.sh
syno.plexupdate.v2.9.9.2.sh
...
The Archive directory structure contains copies of update Packages as well as copies of the update Scripts that are running. However, the script archive is not a mirror of what is on GitHub. The script archive are a snapshot of running copies of the script. If you make modifications to the script, the copy in the script archive will be updated accordingly. The packages archive is similarly intended for manual rollback purposes.
The 'changelog.txt
' file is a historical changelog only for updates installed locally by the script. It will not contain any historical information for versions that were otherwised skipped by the script.
Dear user,
Task Scheduler has completed a scheduled task.
Task: Syno.Plex Update
Start time: Tue, 20 Aug 2024 12:05:36 GMT
Stop time: Tue, 20 Aug 2024 12:06:21 GMT
Current status: 1 (Interrupted)
Standard output/error:
SYNO.PLEX UPDATE SCRIPT v4.4.1 for DSM 7
Script: syno.plexupdate.sh
Script Dir: /volume1/homes/admin/scripts/bash/plex/syno.plexupdate
Running Ver: 4.4.1
Online Ver: 4.5.0 (59/60)
Released: 2024-08-20 18:30:14-07:00 (0+ days old)
* Newer version found!
INSTALLING NEW SCRIPT:
----------------------------------------
2024-08-20 19:09:07 URL:https://raw.githubusercontent.com/michealespinola/syno.plexupdate/v4.5.0/syno.plexupdate.sh [17155/17155] -> "/volume1/homes/admin/scripts/bash/plex/syno.plexupdate/Archive/Scripts/syno.plexupdate.sh" [1]
'/volume1/homes/admin/scripts/bash/plex/syno.plexupdate/Archive/Scripts/syno.plexupdate.sh' -> '/volume1/homes/admin/scripts/bash/plex/syno.plexupdate/Archive/Scripts/syno.plexupdate.sh.cmp'
renamed '/volume1/homes/admin/scripts/bash/plex/syno.plexupdate/Archive/Scripts/syno.plexupdate.sh' -> '/volume1/homes/admin/scripts/bash/plex/syno.plexupdate/syno.plexupdate.sh'
----------------------------------------
* Script update succeeded!
RELEASE NOTES:
----------------------------------------
1. Fixed bug introduced in Plex back end causing null data fields
2. Added command line option for modifying MinimumAge variable
3. Tweaked how TodaysDate variable is captured
4. Tweaked how long SrceFolder variables are displayed
----------------------------------------
Report issues to: https://github.com/michealespinola/syno.plexupdate/issues
Synology: DS1019+ (x86_64), DSM 7.2.1-69057 Update 5
Plex Dir: /volume4/PlexMediaServer/AppData/Plex Media Server
Running Ver: 1.40.5.8854
Online Ver: 1.40.5.8897 (Beta Channel)
Released: 2024-08-20 08:51:24-07:00 (0+ days old)
* Newer version found!
New Package: PlexMediaServer-1.40.5.8897-e5987a19d-x86_64_DSM7.spk
Package Age: 0+ days old (0+ required for install)
INSTALLING NEW PACKAGE:
----------------------------------------
Downloading PlexMediaServer package:
Stopping PlexMediaServer service:
{"action":"stop","beta":false,"error":{"code":0},"finished":true,"language":"enu","last_stage":"stopped","package":"PlexMediaServer","pid":25669,"scripts":[{"code":0,"message":"","type":"stop"}],"stage":"stopped","status":"stop","status_code":324,"status_description":"translate from systemd status","success":true,"username":"","version":"1.40.5.8854-7000"}
Installing PlexMediaServer update:
{"error":{"code":0},"results":[{"action":"upgrade","beta":false,"betaIncoming":false,"error":{"code":0},"finished":true,"installReboot":false,"installing":true,"language":"enu","last_stage":"postupgrade","package":"PlexMediaServer","packageName":"Plex Media Server","pid":25843,"scripts":[{"code":0,"message":"","type":"preupgrade"},{"code":0,"message":"","type":"preuninst"},{"code":0,"message":"","type":"postuninst"},{"code":0,"message":"","type":"preinst"},{"code":0,"message":"Installation Successful!
"type":"postinst"},{"code":0,"message":"","type":"postupgrade"}],"spk":"/volume1/homes/admin/scripts/bash/plex/syno.plexupdate/Archive/Packages/PlexMediaServer-1.40.5.8897-e5987a19d-x86_64_DSM7.spk","stage":"installed_and_stopped","status":"stop","status_code":273,"status_description":"translate from systemd status","success":true,"username":"","version":"1.40.5.8854-7000"}],"success":true}
Starting PlexMediaServer service:
{"action":"start","beta":false,"error":{"code":0},"finished":true,"language":"enu","last_stage":"started","package":"PlexMediaServer","pid":26409,"scripts":[{"code":0,"message":"","type":"start"}],"stage":"started","status":"running","success":true,"username":"","version":"1.40.5.8897-7000"}
----------------------------------------
Update from: 1.40.5.8854
to: 1.40.5.8897 succeeded!
NEW FEATURES:
----------------------------------------
* (Log) Reduced the number of log messages generated when starting playback on an NVIDIA device. (PM-1417)
* (Windows) noautorestart command line parameter added which prevents PMS from restarting after an auto update (PM-1305)
----------------------------------------
FIXED FEATURES:
----------------------------------------
* (Analysis) Preview thumbnail generation would not run on newly added media regardless if the preference was set (PM-1782)
* (Lyrics) Sidecar lyrics would fail to load (PM-1865)
* (QNAP) PMS might not start in all cases after QTS/QuTS restart.
* (ToneMapping) Tonemapping on linux with Gemini Lake devices would crash after a period of time. (PM-1934)
* (ToneMapping) Tonemapping on linux with some Intel devices caused the transcoder to crash (PM-1934)
* (View State Sync) Item plays could be duplicated when state synced from service.
* (ViewStateSync) Fewer requests to plex.tv endpoints (PM-1958)
* (Windows 64bit) Not all files were removed on uninstall (PM-1632)
* Plex Media Server could crash when falling back to SW encoding. (#15026)
----------------------------------------
From SYNOLOGY
The script utilizes (4) default but user-configurable variables:
MinimumAge=7
OldUpdates=60
NetTimeout=900
SelfUpdate=0
Interrupted (1)
" and the notification email will state "Current status: 1 (Interrupted)
". This exit/error status of (1) is intentionally caused by the script in order to force the DSM to perform an email notification of a successful update (in the form of an interruption/error). The DSM otherwise would only send notifications of failed task events, and notifications of successful Plex updates would not be possible.error = [289]
" during the package installation process. Synology DSM 6 has been known to sporadically "lose" 3rd-party security certificates for unknown reasons. If this happens, you will have to re-add the Plex 'Public Key Certificate' to your system. DSM 7 no longer has this requirement.Bash shell scripts running on Linux must be saved as LF (Line Feed) sequenced text. Alternatively, Windows typically uses CRLF (Carriage Return Line Feed). If you inadvertantly save your script with CRLF instead of LF sequencing, it will error with verbiage such as:
'\r': command not found
syntax error near unexpected
To resolve this issue you will need to [re]save your copy of the script with LF sequencing, or download a new copy directly from GitHub.
Many thanks to: