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:
- 🚀 Using the installer
- 🚧 Using Ansible
Minimum system requirements
- 1 Ghz Processor
- 2 GB RAM recommended (1 GB required)
- A static external IP address (How to setup a static ip using Netplan)
One of the supported distribution releases:
Make sure that you have configured a firewall and it's not blocking connection to the desired ports.
LibreTime requires the following default ports to be open:
80for the web interface,
8000for the Icecast streams,
8002for the live stream input endpoint.
Using the installer
The installer is shipped in the released tarballs or directly in the project repository.
Before installing LibreTime, you need to make sure you operating system is properly configured.
Operating system time configuration
Check your operating system time configuration using the following command:
Local time: Fri 2022-08-05 12:43:39 CEST
Universal time: Fri 2022-08-05 10:43:39 UTC
RTC time: Fri 2022-08-05 10:43:40
Time zone: Europe/Berlin (CEST, +0200)
System clock synchronized: yes
NTP service: active
RTC in local TZ: no
Make sure that your time zone is properly configured, if not you can set it using the
timedatectl set-timezone command.
If the NTP service is inactive, you should consider enabling it using the
timedatectl set-ntp command.
You can either download the latest released tarball or clone the repository.
- Release tarball
- Git 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.13.tar.gz && cd libretime
Clone the project repository:
git clone https://github.com/libretime/libretime
Don't use the https://github.com/libretime/libretime-debian-packaging repository, it is only used to create LibreTime packages.
When upgrading, you should clean the local repository, pull the latest changes and finally check out the desired version:
git clean -xdf
And checkout the latest version:
git checkout 3.0.0-alpha.13
Run the installer
Install LibreTime with the recommended options, be sure to replace
PUBLIC_URL with the public url of your installation,
sudo ./install PUBLIC_URL
When upgrading be sure to run the installer using the same arguments you used during the initial install.
If you need to change some configuration, the install script can be configured using flags or environment variables. Changing the listening port of LibreTime or whether you want to install some dependency by yourself, you could run the following:
# Install LibreTime on your system with the following tweaks:
# - do not install the liquidsoap package (remember to install liquidsoap yourself)
# - set the listen port to 8080
# - do not run the PostgreSQL setup (remember to setup PostgreSQL yourself)
--listen-port 8080 \
You can persist the install configuration in a
.env file next to the install script. For example, the above command could be persisted using the
.env file below, and you should be able to run the install script without arguments:
The install script will use randomly generated passwords to create the PostgreSQL user, RabbitMQ user and to update the default Icecast passwords. Those passwords will be saved to the configuration files.
Feel free to run
./install --help to get more details.
Using hardware audio output
If you plan to output analog audio directly to a mixing console or transmitter, the user running LibreTime needs to be added to the
audio user group using the command below:
sudo adduser libretime audio
Once the installation is completed, edit the configuration file at
/etc/libretime/config.yml to fill required information and to match your needs.
Next, run the following commands to setup the database:
sudo -u libretime libretime-api migrate
Synchronize the new Icecast passwords into the database:
sudo libretime-api set_icecast_passwords --from-icecast-config
Finally, start the services, and check that they are running properly using the following commands:
sudo systemctl start libretime.target
sudo systemctl --all --plain | grep libretime
Once the setup is completed, log in the interface and make sure to edit the project settings (go to Settings > General) to match your needs. Important settings are:
- First day of the week
Once completed, it's recommended to install a reverse proxy to setup SSL termination and secure your installation.