Install

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

tip

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

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

• 🚀 Using the installer
• 🚧 Using Ansible

Minimum system requirements

• One of the following Linux distributions
  • Ubuntu current LTS. Note Ubuntu 22.04 LTS is not yet supported
  • Debian current stable
• 1 Ghz Processor
• 2 GB RAM recommended (1 GB required)
• A static external IP address (How to setup a static ip using Netplan)

Using the installer

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

Download

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

Release tarball

Download the latest released tarball from Github.

Or directly from the command-line:

wget https://github.com/libretime/libretime/releases/download/3.0.0-alpha.12/libretime-3.0.0-alpha.12.tar.gz

And extract the tarball:

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

Git repository

Clone the project repository:

git clone https://github.com/libretime/libretime
cd libretime

caution

Don't use the https://github.com/libretime/libretime-debian-packaging repository, it is only used to create LibreTime packages.

info

When upgrading, you should clean the local repository, pull the latest changes and finally check out the desired version:

cd libretime
git clean -xdf
git pull

And checkout the latest version:

git checkout 3.0.0-alpha.12

Run the installer

Install LibreTime with the recommended options:

sudo ./install -fiap

Additional options can be listed with the following command:

./install --help

info

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.

note

• 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.

warning

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

• How to setup a firewall using UFW

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.