4.5 KiB
Installing LibreTime
There two methods of installing LibreTime - Source or Ubuntu package.
Source
Requirements:
- LibreTime should generally be installed on a dedicated host running Ubuntu Server 18.04 LTS, have at least 1 GHz of processor power, at least 2 GB of system RAM, and static IP address.
- LibreTime is undergoing active development, and is currently in ALPHA. Make sure it is working for your needs well before you begin to use it in a live environment.
- Please review the release notes of the version you are planning on installing.
The easiest way to install LibreTime is by cloning the repository using git, and then running the installer.
- If you don't have git installed already, run
sudo apt install git -y - Create a folder in your home directory for the download and change to it:
cd ~ && mkdir LibreTime && cd LibreTime - Clone the repo:
git clone https://github.com/LibreTime/libretime.git - Run the installer:
sudo ./install -fiap - After the installer is finished, follow the instructions to proceed to the setup wizard
It's recommended to use the -fiap flag to install LibreTime on a fresh server install. This way,
all dependencies will be installed and configured by the installer without needing user input.
For those who plan to manually configure LibreTime, options for the installer are listed below:
-h, --help, -?
Display usage information
-V, --version
Display version information
-v, --verbose
More output
-q, --quiet, --silent
No output except errors
-f, --force
Turn off interactive prompts
--distribution=DISTRIBUTION
Linux distribution the installation is being run on
--release=RELEASE
Distribution release
-d, --ignore-dependencies
Don't install binary dependencies
-w, --web-user=WEB_USER
Set the apache web user. Defaults to www-data. Only change
this setting if you've changed the default apache web user
-r, --web-root=WEB_ROOT
Set the web root for Airtime files
This will copy the Airtime application files, but you will need
to give your web user access to the given directory if it is
not accessible
--web-port=WEB_PORT
Set what port the LibreTime interface should run on.
-I, --in-place
Set the current Airtime directory as the web root
Note that you will need to give your web user permission to
access this directory if it is not accessible
-p, --postgres
Create a default postgres user named 'airtime' with password
'airtime'
-a, --apache
Install apache and deploy a basic configuration for Airtime
-i, --icecast
Install Icecast 2 and deploy a basic configuration for Airtime
--selinux
Run restorecon on directories and files that need tagging to
allow the WEB_USER access
--no-postgres
Skips all postgres related install tasks (Useful if you configure
postgresql as part of another script / docker builds)
--no-rabbitmq
Skips all rabbitmq related install tasks.
A great tutorial video on how to install LibreTime is here.
Ubuntu Package
LibreTime maintains amd64 .deb packages for Ubuntu 16.04 (Xenial) and 18.04 (Bionic). These can be downloaded here. Issues with installation of these packages should be reported to the LibretTime/libretime-debian-packaging repository.
These are installed by running the following from the command line (the ./ in
front of the libretime package is important):
sudo apt install icecast2 ./libretime_<version>_amd64.deb
<version> is replaced by the version of the package downloaded.
Alternative OS installations
Installation in Debian 9 and other Linux distributions is possible, but these are less tested.
Plans are in the works for .rpm packages, as well as Docker and AWS images. If you would like to try LibreTime in a Docker image, odclive's (unofficial) image is a great place to start.
Please note that the install script does not take care to ensure that any packages installed are set up in a secure manner. Please see the chapter on preparing the server for more details on how to set up a secure installation.