mirage 0,1 travis-ci docker

MirageOS is a library operating system that constructs unikernels


MirageOS is a library operating system that constructs unikernels for secure, high-performance network applications across a variety of cloud computing and mobile platforms. Code can be developed on a normal OS such as Linux or MacOS X, and then compiled into a fully-standalone, specialised unikernel that runs under the Xen hypervisor. Since Xen powers most public cloud computing infrastructure such as Amazon EC2 or Rackspace, this lets your servers run more cheaply, securely and with finer control than with a full software stack.

The most up-to-date documentation can be found at the homepage. The site is self-hosted and a useful example. Simpler skeleton applications are also available online.

Build Status docs

This repository

This repository includes:

  • a command-line tool to create and deploy applications with MirageOS; and
  • in types/, a library of type signatures that compliant applications use.

There are several diverse backends in MirageOS that require rather specialised build steps (from Xen to KVM unikernels), and this complexity is wrapped up in the tool.

To work with mirage, you’ll need to either install prerequisites locally or use the Docker image.

Local install

You will need the following:

  • a working OCaml compiler (4.02.3 or higher).
  • the OPAM source package manager (1.2.2 or higher).
  • an x86_64 or armel Linux host to compile Xen kernels, or FreeBSD, OpenBSD or MacOS X for the userlevel version.

Docker image

There is a maintained Docker image at unikernel/mirage. You can also use the Dockerfile in this repository:

docker build -t mirage .
docker run -v <your-source>:/src opam config exec -- mirage

Using mirage

There are two stages to using mirage:

  • a configure phase where OPAM package dependencies are satisfied.
  • a build phase where the compiler and any support scripts are run.

You can find documentation, walkthroughs and tutorials over on the MirageOS website. The install instructions are a good place to begin!

Related Repositories






MirageOS is a library operating system that constructs unikernels ...



A client-side mock server to develop, test and prototype your app ...



Core platform libraries for Mirage (UNIX and Xen). This provides the `OS` library which handles timers, device setup and the main loop, as well as the runtime for the Xen unikernel. ...



docker front end & reverse proxy for development ...

Top Contributors

avsm samoht Drup yomimono talex5 nojb hannesm djs55 pqwy mor1 mattgray vbmithr mato yallop MagnusS dsheets jvirtanen amirmc lnmx moonlightdrive pgj mootpt djwillia matildah paurkedal sevenEng little-arhat simonjbeaumont ansiwen


-   v2.9.1 zip tar
-   v2.9.0 zip tar
-   v2.8.0 zip tar
-   v2.7.3 zip tar
-   v2.7.2 zip tar
-   v2.7.1 zip tar
-   v2.7.0 zip tar
-   v2.6.1 zip tar
-   v2.6.0 zip tar
-   v2.5.1 zip tar
-   v2.5.0 zip tar
-   v2.4.0 zip tar
-   v2.3.0 zip tar
-   v2.2.1 zip tar
-   v2.2.0 zip tar
-   v2.1.1 zip tar
-   v2.1.0 zip tar
-   v2.0.1 zip tar
-   v2.0.0 zip tar
-   v1.2.0 zip tar
-   v0.9.7 zip tar
-   v0.9.6 zip tar
-   v0.9.5 zip tar
-   v0.9.4 zip tar
-   regression-20110325 zip tar
-   regression-20110319 zip tar
-   mirari-0.9.3 zip tar
-   mirari-0.9.2 zip tar
-   mirari-0.9.1 zip tar
-   mirari-0.9.0 zip tar