package mirage

  1. Overview
  2. Docs
The MirageOS library operating system

Install

Dune Dependency

Authors

Maintainers

Sources

mirage-4.7.0.tbz
sha256=ade8c410b2de3997c4a513f53f6c990dac6af508161e20df01b64fa7975ca5be
sha512=42fddf09be84c4251417145b88d4f63b41db1b29c9622b2b4e4508e31146f227a16875e670da96251208745f79a42f0b7d2bd8b44b883a705381b4c97a4255b8

Description

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.

Tags

org:mirage org:xapi-project

Published: 05 Sep 2024

README

README.md

MirageOS logo
Build Unikernels in OCaml


MirageOS is a library operating system that constructs secure, performant and resource-efficient unikernels.

About

MirageOS is a library operating system that constructs unikernels for secure, high-performance network applications across various cloud computing and mobile platforms. Developers can write code on a traditional OS such as Linux or macOS. They can then compile their code into a fully-standalone, specialised unikernel that runs under the Xen or KVM hypervisors and lightweight hypervisors like FreeBSD's BHyve, OpenBSD's VMM. These unikernels can deploy on public clouds, like Amazon's Elastic Compute Cloud and Google Compute Engine, or private deployments.

The most up-to-date documentation can be found at the homepage. The site is a self-hosted unikernel. Simpler skeleton applications are also available online. MirageOS unikernels repositories are also available here or there.

This repository

This repository contains the mirage command-line tool to create and deploy applications with MirageOS. This tool wraps the specialised configuration and build steps required to build MirageOS on all the supported targets.

Local install

You will need the following:

  • a working OCaml compiler (4.08.0 or higher).

  • the Opam source package manager (2.1.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.

Then run:

$ opam install mirage
$ mirage --version

This should display at least version 4.0.0.

Using mirage

There are multiple stages to using mirage:

  • write config.ml to describe the components of your applications;

  • call mirage configure to generate the necessary code and metadata;

  • optionally call make depends to install external dependencies and download Opam packages in the current dune workspace.

  • call dune build to build a unikernel.

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

Dependencies (13)

  1. opam-monorepo >= "0.4.0"
  2. logs >= "0.7.0"
  3. uri >= "4.2.0"
  4. rresult >= "0.7.0"
  5. fpath
  6. bos
  7. ipaddr >= "5.0.0"
  8. fmt >= "0.8.7"
  9. emile >= "1.1"
  10. cmdliner >= "1.2.0"
  11. astring
  12. dune >= "2.9.0"
  13. ocaml >= "4.08.0"

Dev Dependencies (4)

  1. mirage-runtime with-test & = version
  2. alcotest with-test
  3. cmdliner with-test & >= "1.3.0"
  4. ocaml with-test & < "5"

Used by (4)

  1. conan >= "0.0.2"
  2. conan-cli >= "0.0.2"
  3. docteur < "0.0.2"
  4. nbd = "3.0.0"

Conflicts (1)

  1. jbuilder with-test
OCaml

Innovation. Community. Security.