53 lines
2.8 KiB
Markdown
53 lines
2.8 KiB
Markdown
# Installing LibreTime
|
|
There two methods of installing LibreTime - [Source](#source) or
|
|
[Ubuntu package](#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 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.
|
|
- Complete the [Preparing the server](preparing-the-server) guide before proceeding
|
|
|
|
The easiest way to install LibreTime is by cloning the repository using git, and
|
|
then running the installer.
|
|
|
|
1. If you don't have git installed already, run `sudo apt install git -y`
|
|
2. Create a folder in your home directory for the download and change to it: `cd ~ && mkdir LibreTime && cd LibreTime`
|
|
3. Clone the repo: `git clone https://github.com/LibreTime/libretime.git`
|
|
4. Run the installer: `sudo ./install -fiap`
|
|
5. After the installer is finished, follow the instructions to proceed to the [setup wizard](manual/getting-started/index.md)
|
|
|
|
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 -f` to see all installer options.
|
|
|
|
A great tutorial video on how to install LibreTime is [here](https://www.youtube.com/watch?v=Djo_55LgjXE).
|
|
|
|
## 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.
|
|
|
|
## 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](https://hub.docker.com/r/odclive/libretime-docker) 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](manual/preparing-the-server) for more details on
|
|
how to set up a secure installation.
|