sintonia/docs/vagrant.md

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

• Git
• VirtualBox
• Vagrant

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

If everything works out, you will find LibreTime on port 9080, 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 in the libretime directory.

Troubleshooting

If anything fails during the initial provisioning step you can try running vagrant provision to rerun the installer.