Updates and backups
Two habits keep a server healthy: update it when a new version is out, and keep a backup somewhere other than the server computer.
Update the server
- On Mac, choose Check for Updates… in the WatchMyMedia menu.
- On Windows, choose Check for updates… in the WatchMyMedia menu by the clock, or download and run the newest installer to upgrade in place.
-
On Debian, Ubuntu or Fedora, new versions come with the system's other updates. To update only WatchMyMedia, run
sudo apt update && sudo apt install --only-upgrade watchmymediaon Debian or Ubuntu, orsudo dnf upgrade --refresh watchmymediaon Fedora. The update restarts the server. - On Unraid or Docker, update the container: Keep it updated has Unraid's steps.
Settings › General in the web app has Check for updates too. It tells an admin whether a newer version is out and shows its notes. Nothing is checked in the background.
Back up first. Some updates change the server's database, and after one of those an older version can't use your data again. The notes for each version say whether it does. 2.0.0 does: going back to 1.8.0 afterwards needs a backup made before you updated. Choose Back up now under Settings › Backups, then update.
On Debian, Ubuntu and Fedora the system can update WatchMyMedia along with everything else, before you've made one. The way back
is then the last backup the server made before the update. Backups are in the backups folder, named by the date
and time they were made, in UTC. The server makes one soon after it starts, so the newest may already be from after the update.
Avoid updating while something is recording: the recording carries on after the restart, with the minutes in between missing.
Update the apps
The iPhone, iPad, Apple TV and Android apps update from the App Store and Google Play like any other app. The server and the apps can be updated in any order: an app on an older version keeps working with a newer server, and shows new features once it is updated too.
From 2.0.0 the iPhone, iPad and Apple TV apps have the server's version number. Before, their App Store number ran ahead of it.
Back up
The server makes a backup every night by itself. Under Settings › Backups an admin can also choose Back up now, choose how many Nightly backups to keep, and download one.
Those backups sit on the server computer, which doesn't help if its disk fails. Download one now and then and keep it somewhere else, such as another computer or a drive you unplug.
What a backup holds
- In it: your libraries and their matches, everyone's accounts and watch history, the server's settings and
config.yaml, posters you chose yourself, and subtitles downloaded from OpenSubtitles. - Not in it: your video files. A backup is small because it doesn't hold them, so keep your own copies of anything you can't replace.
- Made again when needed: downloaded artwork, converted subtitles and seek thumbnails.
- Left out on purpose: sign-ins, so whoever holds a backup can't use it to play from your server, and the sign-in to a connected Plex server. After a restore, everyone signs in again on every device, and an admin connects to Plex again.
Restore a backup
Settings › Backups › Restore from a backup has these steps with the commands for how your server is installed, and Print, so you have them while the server is stopped.
- Quit WatchMyMedia, so the server is stopped.
- Open the data folder (below) and unpack the backup into it, replacing the
watchmymedia.dbthat is there. - Open WatchMyMedia again.
- Sign in again: everyone does, on every device. An admin signs in to Plex again if it was connected.
The server comes back as it was when the backup was made. Anything watched or changed since then is not in it.
On Debian, Ubuntu and Fedora the server is a system service, so the steps on that page stop and start it with
systemctl, unpack the backup as the watchmymedia user, and put the settings file back in
/etc/watchmymedia.
Where your data is kept
- On Mac:
~/Library/Application Support/WatchMyMedia, with logs in~/Library/Logs/WatchMyMedia. In Finder, choose Go › Go to Folder… and paste the path. Show Logs in the menu opens the logs. - On Windows:
%LOCALAPPDATA%\WatchMyMedia, with logs in its Logs folder. Paste the path into File Explorer's address bar. -
On Debian, Ubuntu or Fedora:
/var/lib/watchmymedia, with the settings file in/etc/watchmymediaand logs in the system's journal:sudo journalctl -u watchmymedia. - On Unraid: the appdata path you chose,
/mnt/user/appdata/watchmymediaunless you changed it.
Backups are in the backups folder inside it.
Keep it running
Turn on Launch at Login on Mac or Start at sign-in on Windows, so the server starts again after a restart, once you've signed in to the computer. WatchMyMedia keeps the computer awake while something plays or records, but can't wake it from sleep, so a computer that sleeps misses recordings and can't be reached.
On Debian, Ubuntu and Fedora the server is a system service: it starts with the computer, before anyone signs in. Set the computer not to sleep when it's idle.
If it doesn't work
Written for WatchMyMedia 1.4.7 on November 16, 2026; restoring a backup is not yet followed step by step on a Mac or a PC. The Debian, Ubuntu and Fedora lines were added on November 18, 2026, for WatchMyMedia 1.7.0, the first release with those packages, and have not been followed on a real system. Back up first was updated for WatchMyMedia 2.0.0 on November 21, 2026. Moving a server to a new computer will be added once it has been checked end to end.