Congegni
/
libretime
mirror of https://github.com/libretime/libretime.git
7
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
libretime/docs/install.md

2.7 KiB
Raw Blame History

Installing LibreTime

There two methods of installing LibreTime - Source or Ubuntu package. Please complete the Preparing the server and Setting the server time guides before proceeding.

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 a 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.

cd ~ && git clone https://github.com/LibreTime/libretime.git
sudo ./libretime/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, run sudo ./install -h to see all installer options.

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.