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
- 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
- Git repository
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
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.
LibreTime requires the following ports to be open:
80
for the web interface,8000
for the Icecast streams,8001
and8002
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.