vagrant-icebox

A vagrant environment to develop Icebox and VirtualBox VMI

Table of Contents

• Overview
• Requirements
• Setup
• Troubleshooting
• References
• Maintainers
• Contributing
• License

Overview

Icebox is a debugger and tracer working at the hypervisor-level, via virtual machine introspection.

As it requires a modified VirtualBox and a complicated setup, this project aims to lower the entry barrier for curious developers and users.

Requirements

• vagrant
• vagrant-libvirt plugin (packaged in Debian/Ubuntu)
• vagrant-reload plugin
• ansible >= 2.2.1.0

Setup

Example setup on Debian Buster

$ sudo apt-get install -y vagrant ruby-dev
$ sudo apt-get install vagrant vagrant-libvirt
$ vagrant plugin install vagrant-reload

Vagrantfile

Tune the Vagrantfile configuration to your needs.

Build the environment

• Run vagrant up --provider=libvirt or vagrant up --provider=virtualbox
• Once the provisioning via Ansible is done, ssh into the box with vagrant ssh

Troubleshooting

NFS

You need to open your firewall for NFS. The following commands should make it work for a Vagrant box to access your host NFS server:

firewall-cmd --permanent --add-service=nfs
firewall-cmd --permanent --add-service=rpc-bind
firewall-cmd --permanent --add-service=mountd
firewall-cmd --reload

References

• Icebox: Virtual Machine Introspection, Tracing & Debugging

Maintainers

@Wenzel

Contributing

PRs accepted.

Small note: If editing the Readme, please conform to the standard-readme specification.

License

GNU General Public License v3.0