Skip to main content
Version: Stable 4.x

Migrate from Airtime

This guide walk you though the steps required to migrate your data from Airtime to LibreTime.

info

Airtime linked files and watched folders features are either deprecated or not working in LibreTime.

LibreTime dropped support for Ubuntu 16.04, which is the last supported version of Ubuntu that Airtime supports.

To have a better understanding of the next steps, please read the following documentation before you continue:

Make a backup​

Backup the configuration​

On common setups, you need to backup the entire /etc/airtime folder.

Backup the database​

You need to backup the PostgreSQL database, which holds the entire data of your installation.

Here is an example to dump your PostgreSQL database:

sudo -u postgres pg_dump --no-owner --no-privileges airtime > airtime.sql

Please read the pg_dump usage for additional details.

Backup the storage​

You need to backup the entire file storage, which holds all the files of your installation.

The path to your storage was defined during the installation process, the default storage path is /srv/airtime/stor.

Install​

Install LibreTime on a new system by running the installer, and don't run the setup tasks.

Restore the Airtime backup​

Restore the Airtime backup on the newly installed LibreTime server.

Restore the storage​

Restore the storage by moving the files the your new storage location, the new default storage path is /srv/libretime.

Update the configuration​

The configuration file changed a lot between Airtime and LibreTime, please take the time to understand it.

Update the new LibreTime configuration file to match your previous Airtime settings. See the configuration documentation for more details.

The installer already configured random passwords for Icecast. If you need to restore the Icecast passwords used in Airtime, you have to edit the Icecast password in /etc/icecast2/icecast.xml and in the LibreTime configuration file.

Restore the database​

Restore the database by using the following command:

sudo -u libretime libretime-api dbshell < airtime.sql

Apply migrations​

Run the following command to apply the database migrations:

sudo -u libretime libretime-api migrate

Finish​

Restart the LibreTime services and navigate to the LibreTime web-page.