Skip to main content
Version: 3.0.0-alpha.12


This guide walk you though the steps required to install LibreTime on your system.


If you are coming from Airtime, please follow the Airtime migration guide.

You can install LibreTime using the one of the following methods:

Minimum system requirements

Using the installer

The installer is shipped in the released tarballs or directly in the project repository.


You can either download the latest released tarball or clone the repository.

Download the latest released tarball from Github.

Or directly from the command-line:


And extract the tarball:

tar -xvf libretime-3.0.0-alpha.12.tar.gz && cd libretime

Run the installer

Install LibreTime with the recommended options:

sudo ./install -fiap

Additional options can be listed with the following command:

./install --help

When upgrading be sure to run the installer using the same arguments you used during the initial install.

Once the installation is completed, open http://localhost:80 to complete the setup wizard.

  • If installed on a remote device, make sure to replace localhost with your server's remote address.
  • If installed with a custom port, make sure to replace 80 with the custom port.

Make sure that you have configured a firewall and it's not blocking connection to the desired ports.

LibreTime requires the following ports to be open:

  • 80 for the web interface,
  • 8000 for the Icecast streams,
  • 8001 and 8002 for the live stream input endpoint.

Consider putting your installation behind a reverse proxy to increase the security.

Using hardware audio output

If you plan to output analog audio directly to a mixing console or transmitter, the user running LibreTime (by default www-data) needs to be added to the audio user group using the command below:

sudo adduser www-data audio

Setup wizard

The setup wizard walk you through the rest of the installation process.

Changing default passwords

It's recommended that you change the passwords prompted in the setup wizard. Be sure to apply the changes on the server before going to any next step.

You can change the default PostgreSQL user password using:

sudo -u postgres psql -c "ALTER USER airtime PASSWORD 'new-password';"

You can change the default RabbitMQ user password using:

sudo rabbitmqctl change_password "airtime" "new-password"

Once completed, it's recommended to install a reverse proxy to setup SSL termination and secure your installation.

Using packages


Usually the packages are built soon after a release is published.

You can install LibreTime using packages on the distributions listed below, please follow further instruction provided by the links below: