Commit 7b21c4f8 authored by godog's avatar godog

docs: update quickstart for Buster

Virtualbox has been removed from Debian Buster: https://bugs.debian.org/794466
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](https://ansible.com) (>= 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:
```shell
echo deb http://deb.debian.org/debian 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 git.autistici.org/ale/x509ca
go get -u git.autistici.org/ale/ed25519gen
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.
```shell
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
available.
## 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