Note: this guide is assuming you are using Ubuntu 18.04 LTS for installation, which comes with
Minimum System Requirements
- One of the following Linux distributions
- Ubuntu 18.04 LTS
- Debian 10
- Raspberry Pi OS 10 (formerly Raspbian)
- 1 Ghz Processor
- 2 GB RAM recommended (1 GB required)
- Wired internet connection and static IP address for on-prem install
Preparing the server
Configure the server to have a static IP address by modifying the Netplan configuration. If you’re using a cloud VM, you likely already have a static IP address. Check with your provider to confirm this.
cd /etc/netplan && ls # find the netplan filename sudo nano ##-network-manager-all.yaml
If the Netplan configuration is empty, fill in the file with the example below. Otherwise,
input the IP address reserved for the server in
xxx.xxx.xxx.xxx/yy format, the gateway (the IP address
of your router), and the DNS nameserver. If you don’t have a nameserver on your network,
feel free to use Cloudflare’s:
22.214.171.124. In this File is “Tab” not allowed.
network: version: 2 renderer: networkd ethernets: enp3s0: addresses: [192.168.88.8/24] gateway4: 192.168.88.1 nameservers: addresses: [192.168.88.1]
After the netplan file has been saved, run
sudo netplan apply to apply changes.
Next, configure Ubuntu’s firewall by running:
sudo ufw enable sudo ufw allow 22,80,8000/tcp
Unblock ports 8001 and 8002 if you plan to use LibreTime’s Icecast server to broadcast livestreams without an external Icecast server acting as a repeater.
sudo ufw allow 8001,8002/tcp
If needed, instructions for setting up a reverse proxy can be found here.
Installing LibreTime consists of running the following commands in the terminal:
git clone https://github.com/LibreTime/libretime.git cd libretime sudo bash install -fiap
After the install is completed, head to the IP address of the server LibreTime was just installed on to complete the welcome wizard. While not strictly necessary, it is recommended that you change the passwords prompted in the welcome wizard if you intend on accessing the server from the Internet. The welcome wizard will walk you through the rest of the installation process.
Once all of the services needed to run LibreTime are installed and configured,
it is important that the server starts them during the boot process, to cut down on downtime, especially in live environments.
Ubuntu 18.04 uses the
systemctl command to manage services, so run the following commands to enable all
LibreTime-needed services to run at boot:
sudo systemctl enable libretime-liquidsoap sudo systemctl enable libretime-playout sudo systemctl enable libretime-celery sudo systemctl enable libretime-analyzer sudo systemctl enable apache2 sudo systemctl enable rabbitmq-server
If an error is returned, try adding
.serviceto the end of each command.
If you plan to have LibreTime output analog audio directly to a mixing console or transmitter,
www-data user needs to be added to the
audio user group using the command below:
sudo adduser www-data audio