What Is This?

simple-nat is a MirageOS project that provides a NAT device with storage backed by Irmin. The NAT table is exposed by an Irmin HTTP server and can be manipulated by Irmin's command-line tools, in addition to the automatic updates which are triggered by normal operation of the NAT device.

For more background, see the irmin-arp documentation.

Prepare

Currently, pinned versions of dolog and bin_prot are necessary to run applications using Irmin as unikernels. Get them here:

opam pin add dolog https://github.com/unixjunkie/dolog.git#no_unix
opam pin add bin_prot https://github.com/samoht/bin_prot.git#112.35.00+xen

Additionally, there are some dependencies which are not available in the main OPAM repository. They can be installed as follows:

opam pin add irmin-network-datastores https://github.com/yomimono/irmin-network-datastores.git
opam pin add mirage-nat https://github.com/yomimono/mirage-nat.git
opam pin add irmin-arp https://github.com/yomimono/irmin-arp.git

(optional)

opam pin add lwt https://github.com/mirage/lwt.git#tracing

You'll need mirage itself as well:

opam install mirage

Compile

mirage configure --xen # for a virtual machine
make

Run

For an example configuration and invocation of the NAT device, see multibridge.xl and multibridge.sh.