FreeBSD-Dockerbox

This project is still a work in progress.

This project aims to provide usage of docker on FreeBSD by installing and running dockerd inside a linux bhyve vm called dockerbox.

Installation

To install from Github, clone this repository and run make install.

# Install dockerbox script, config
make install

To install from port, go to /sysutils/dockerbox and run make and make install.

# Install dockerbox script, config
make
make install

Enable the dockerbox service and download the dockerbox disk image.

service dockerbox enable

# fetch disk image
service dockerbox fetch

The make install command automatically detects the default gateway interface for connecting to the Internet. To modify it, edit ext_if specified in /usr/local/etc/dockerbox/dockerbox.conf

ext_if=ue0

Usage

Make sure you have docker installed and dockerbox's disk image downloaded.

pkg install docker

service dockerbox fetch

Also install tools like grub2-bhyve etc else you'll end up seeing error messages like pid 2859 (bhyve), jid 0, uid 0: exited on signal 6 (no core dump - other error) when you start dockerbox.

pkg install grub2-bhyve
pkg install e2fsprogs

Starting dockerbox

service dockerbox start

Export DOCKER_HOST.

export DOCKER_HOST=10.0.0.1:2375

Try out docker!

docker run hello-world

The ip address of dockerbox is currently fixed to 10.0.0.3

Stopping dockerbox

service dockerbox stop

Log is at /var/log/dockerbox.log