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
- One of the following Linux distributions
- 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.
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.12.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.12
Run the installer
Install LibreTime with the recommended options:
sudo ./install -fiap
Additional options can be listed with the following command:
When upgrading be sure to run the installer using the same arguments you used during the initial install.
- If installed on a remote device, make sure to replace
localhostwith your server's remote address.
- If installed with a custom port, make sure to replace
80with 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:
80for the web interface,
8000for the Icecast streams,
8002for 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
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.
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: