Firecracker's Micro Virtual Machines (microVMs) Samples

This repository contains examples of micro virtual machines (microVMs) that can be used with Firecracker

Requirements

• All the samples were built, tested and run using Ubuntu 18.04.1 LTS since you need KVM support in order to run Firecracker. For more information on supported Operating Systems (OS) and requirements please check the Firecracker's FAQ page

Getting Firecracker

In order to run these sample microVMs, please download Firecracker or build it from source following the instructions below:

• Download the Firecracker binary following the Quickstart Guide or

• To build it from source, please follow Firecracker's Getting Started Guide

• Save or copy the downloaded or built firecracker executable to this repository folder in order to run the samples.

Micro Virtual Machines (microVMs) samples

Roadmap

• Provide additional samples that include:

  • Minimal microVM (Done => Echo Time sample)
  • Networking (Done => Web Server sample)
  • microVM Metadata Service (mmds) (TBD)
  • ssh (TBD)

Disclaimer

These sample micro virtual machines (microVMs) are for demonstration purposes only. These are not production ready microVMs.

The samples have been tested but there's no guarantee they will work on different machines and configurations. Some troubleshooting tips are provided in case issues occur. Please use them with caution or setup an experimental environment to test these samples since some samples make modifications in the host machine (e.g. networking, etc.)

The goal of making these microVMs available is to provide a learning resource for people interested in Firecracker's virtual machine manager (vmm) technology.