mirage-runtime

The base MirageOS runtime library, part of every MirageOS unikernel
README

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 traditional OS such as Linux or
MacOS X, and then compiled into a fully-standalone, specialised unikernel that
runs under the Xen or KVM hypervisors as well as lightweight hypervisors like
FreeBSD's BHyve, OpenBSD's VMM. Xen and KVM power many public clouds;
MirageOS unikernels are currently running on Amazon's Elastic Compute Cloud
and Google Compute Engine, and maybe others!

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


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.

Local install

You will need the following:

  • a working OCaml compiler (4.05.0 or higher).

  • the OPAM source package manager (2.0.0 or higher).

  • an x86_64 or armel Linux host to compile Xen kernels, or FreeBSD, OpenBSD or
    MacOS X for the solo5 and userlevel versions.

Using mirage

There are two stages to using mirage:

  • a configure phase where necessary code is generated and dependencies are determined.

  • an optional depends 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!

Install
Published
24 Sep 2020
Sources
mirage-v3.8.1.tbz
sha256=9c83030028b482bdb7e14bb4c4ff9d061a5aa18bcbafa873cb62c940806ba9eb
sha512=7ae6f25a5778738b0acdea59090f8791f0319c3c70a9067cc5762239ba4c75cec8a334b5447da6ed892a9ffa289f313f38df5b0c6089a7298efec0b693799312
Dependencies
lwt
>= "4.0.0"
functoria-runtime
>= "3.0.2" & < "4.0"
ipaddr
>= "5.0.0"
dune
>= "1.1.0"
ocaml
>= "4.06.0"
Reverse Dependencies
mirage
>= "3.0.0" & < "3.1.1" | >= "3.4.0" & < "3.7.1" | >= "3.8.0" & < "3.9.0"
mirage-entropy
>= "0.5.0"
mirage-solo5
>= "0.6.1" & < "0.7.0"
mirage-unix
>= "4.0.0" & < "5.0.0"
mirage-xen
>= "5.0.0" & < "7.0.0"