Skip to main content
Version: Stable 4.x


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


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


You may upgrade LibreTime by migrating to a new server. This is probably the cleanest way if you are coming from Airtime, if you wish to upgrade the underlying system, or if you want to skip multiple upgrade procedures.

Stop the services

Run the following commands to stop the services:

sudo systemctl stop
# Or
sudo systemctl stop libretime-analyzer.service
sudo systemctl stop libretime-api.service
sudo systemctl stop libretime-liquidsoap.service
sudo systemctl stop libretime-playout.service
sudo systemctl stop libretime-worker.service

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.

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.


If you are migrating LibreTime to a new server, you must not apply the upgrade procedure.


You might need to run steps before and after the install procedure. Be sure to follow these steps thoroughly.

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.


If you are migrating LibreTime to a new server, you must stop before the setup tasks and restore the backups on the new server.

Apply migrations

Run the following command to apply the database migrations:

sudo -u libretime libretime-api migrate

Restart the services

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

sudo systemctl restart


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

sudo systemctl --all --plain | egrep 'libretime|nginx|php.*-fpm'

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.