2018-10-05 19:02:54 +02:00
# Installing LibreTime
2020-05-04 15:32:37 +02:00
There two methods of installing LibreTime - [Source ](#source ) or
[Ubuntu package ](#ubuntu-package ).
2020-05-13 15:54:28 +02:00
Please complete the [Preparing the server ](preparing-the-server ) and
[Setting the server time ](manual/setting-the-server-time/index ) guides before proceeding.
2017-03-03 15:43:14 +01:00
2019-11-06 12:55:38 +01:00
## Source
2018-10-12 20:09:19 +02:00
2020-04-30 21:49:30 +02:00
Requirements:
2018-11-21 16:37:18 +01:00
2020-05-10 21:07:10 +02:00
- 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.
2020-04-30 21:49:30 +02:00
- 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.
2018-11-20 21:20:01 +01:00
- Please review the release notes of the version you are planning on installing.
2018-11-20 19:31:34 +01:00
2020-04-30 21:49:30 +02:00
The easiest way to install LibreTime is by cloning the repository using git, and
then running the installer.
2017-03-03 15:43:14 +01:00
2020-05-13 15:59:07 +02:00
```
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 ](manual/getting-started/index.md ).
2020-04-30 21:49:30 +02:00
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.
2020-05-13 15:59:07 +02:00
For those who plan to manually configure LibreTime, run `sudo ./install -h` to see all installer options.
2017-03-03 19:27:51 +01:00
2020-04-26 19:07:38 +02:00
A great tutorial video on how to install LibreTime is [here ](https://www.youtube.com/watch?v=Djo_55LgjXE ).
2018-10-12 20:09:19 +02:00
2019-11-06 12:55:38 +01:00
## Ubuntu Package
LibreTime maintains amd64 .deb packages for Ubuntu 16.04 (Xenial) and 18.04
(Bionic). These can be downloaded [here ](https://github.com/LibreTime/libretime-debian-packaging/releases ).
Issues with installation of these packages should be reported to the
[LibretTime/libretime-debian-packaging ](https://github.com/LibreTime/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.
2018-10-12 20:09:19 +02:00
## Alternative OS installations
2019-11-06 12:55:38 +01:00
Installation in Debian 9 and other Linux distributions is possible, but these
2020-04-30 21:49:30 +02:00
are less tested.
2018-10-05 19:02:54 +02:00
2020-04-26 19:07:38 +02:00
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 ](https://hub.docker.com/r/odclive/libretime-docker ) is a great place to start.
2017-10-07 14:06:48 +02:00
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
2020-01-02 10:10:57 +01:00
[preparing the server ](manual/preparing-the-server ) for more details on
2017-10-07 14:06:48 +02:00
how to set up a secure installation.
