2.4 KiB
The LibreTime Vagrant install is the fastet way to get LibreTime up and running in a way to hack on its source code or to test it locally.
Prerequisites
You might also want to install vagrant-vbguest to update the guest extensions to match your host system on vagrant up.
vagrant plugin install vagrant-vbguest
Starting LibreTime Vagrant
To get started you clone the repo and run vagrant up.
git clone https://github.com/libretime/libretime.git
cd libretime
vagrant up ubuntu-xenial
If everything works out, you will find LibreTime on port 8080, icecast on port 8000 and the docs on port 8888.
Once you reach the web setup GUI you can click through it using the default values. To connect to the vagrant machine you can run vagrant ssh ubuntu-xenial in the libretime directory.
Alternative OS installations
With the above instructions LibreTime is installed on Ubuntu Xenial Xerus. The Vagrant setup offers the option to choose a different operation system according to you needs.
| OS | Command | Comment |
|---|---|---|
| Debian 9.2 | vagrant up debian-stretch |
Install on current Debian Stretch. |
| Debian 8.7 | vagrant up debian-jessie |
Install on Debian Jessie. |
| Debian 7.11 | vagrant up debian-wheezy |
Deprecated install on Debian Wheezy. Please switch to debian-stretch. |
| Ubuntu 18.04 | vagrant up ubuntu-bionic |
Experimental install on current Ubuntu Bionic Beaver. |
| Ubuntu 16.04 | vagrant up ubuntu-xenial |
Install on Ubuntu Xenial Xerus. |
| Ubuntu 14.04 | vagrant up ubuntu-trusty |
Deprecated install on Ubuntu Trusty Tahir. Recommended by legacy upstream. |
| CentOS | vagrant up centos |
Extremely experimental install on 7.3 with native systemd support and activated SELinux. Needs manual intervention due to Liquidsoap 1.3.3. |
Troubleshooting
If anything fails during the initial provisioning step you can try running vagrant provision to rerun the installer.
If you only want to re-run parts of the installer, use --provision-with install. The supported steps are prepare, install, install-mkdocs and start-mkdocs.