Commit 7b21c4f8 authored by godog's avatar godog

docs: update quickstart for Buster

Virtualbox has been removed from Debian Buster:
parent 5989ebc5
Pipeline #3987 passed with stage
in 5 minutes and 59 seconds
......@@ -14,29 +14,31 @@ example service.
You're going to need a relatively recent version of
[Ansible]( (>= 2.4), the virtual machine
management tools (Vagrant and Virtualbox), and a few small other
management tools (Vagrant and libvirt), and a few small other
custom tools used to manage credentials, that we will build ourselves.
On a Debian stable (*stretch*) system, not all packages have
sufficiently recent versions in the main repository. The simplest way
to solve this is to pull some packages from the *stretch-backports*
repository. This can be achieved with the following commands:
On a Debian stable (*buster*) system, run the following:
echo deb stretch-backports main \
| sudo tee /etc/apt/sources.list.d/backports.list
sudo apt update
sudo apt install golang bind9utils
sudo apt install -t stretch-backports ansible vagrant virtualbox
sudo apt install golang bind9utils ansible vagrant libvirt-daemon-system
go get -u
go get -u
export PATH=$PATH:$HOME/go/bin
Since the system's `libvirt` daemon will be used as Vagrant provider,
the user running *float* must belong to the `libvirt` UNIX group to be
able to talk to the daemon.
sudo usermod -a -G libvirt $USER
sg libvirt
Finally, on non-Debian systems it is important to verify that the
default Python installation is Python 2 and not Python 3: while we're
working on supporting both, this is not yet complete and *float* might
break when used with Python 3.
default Python installation is Python 3 and not Python 2. Running from a
virtual environment should work, as long as the *ansible* module is
## Step 2: Set up a new environment
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment