Upgrade

This guide walk you though the steps required to upgrade LibreTime.

tip

You should always have proper backups and a rollback scenario in place before updating. If the update does not go smoothly, it may cause significant downtime, so you should always have a fallback system available during the update to ensure broadcast continuity.

Stop the services

Run the following commands to apply the database migrations:

sudo systemctl stop libretime.target

Make a backup

Follow the backup guide to make an extra backup of your installation and prepare a rollback scenario in case of accidental data loss during the upgrade process.

Install the new version

Follow the install guide to download and install the new version, and re-run the ./install script with the same arguments you used during the initial install.

Apply upgrade instructions

Be sure to carefully read all the releases notes, from your current version to the targeted version, to apply upgrade or breaking changes instructions to your installation.

Apply migrations

Run the following command to apply the database migrations:

sudo -u www-data libretime-api migrate

Restart the services

Restart all the services to make sure all the changes are applied.

sudo systemctl restart libretime.target

Verify

Verify that all the services are still running after the install process:

sudo systemctl --all --plain | egrep 'libretime|apache2'

Verify for any error in the logs after the install process:

sudo tail -f -n 100 "/var/log/syslog" | grep "libretime-"

Log into the interface and verify for any error after the install process.

If you encounter issues with the new interface, you may need to clear your web browser's cache.