Installation

Fogbed comes with two installation and deployment options.

Bare-metal installation

Automatic installation is provided through an Ansible playbook.

• Requires: at least Ubuntu 16.04 LTS

$ sudo apt-get install ansible git aptitude
$ git clone https://github.com/fogbed/fogbed.git
$ cd fogbed/ansible
$ sudo ansible-playbook -i "localhost," -c local install_metis.yml
$ sudo ansible-playbook -i "localhost," -c local install_docker.yml
$ sudo ansible-playbook -i "localhost," -c local --skip-tags "notindocker" install_fogbed.yml

Warning

Unless you are trying to get the best emulation performance, use a VM instead of installing in your own machine, fogbed installation process may mess with your native OS installation or damage it in any way.

Nested Docker deployment

Fogbed can be executed within a privileged Docker container (nested container deployment). There is also a pre-build Docker image available on DockerHub.

# build the container locally
$ docker build -t fogbed .

# or pull the latest pre-built container
$ docker pull fogbed/fogbed

# run the container
$ docker run --name fogbed -it --rm --privileged --pid='host' -v /var/run/docker.sock:/var/run/docker.sock fogbed /bin/bash

Good luck!