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

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, 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](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.