[][unikraft-latest] [][unikraft-license] [][unikraft-discord]

</div> <h1 align="center">The fast, secure and open-source <br /> Unikernel Development Kit</h1> <div align="center"> Unikraft powers the next-generation of cloud native, containerless applications by enabling you to radically customize and build custom OS/kernels; unlocking best-in-class performance, security primitives and efficiency savings. </div> <br /> <p align="center"> <a href="https://unikraft.org">Homepage</a> · <a href="https://unikraft.org/docs">Documentation</a> · <a href="https://github.com/unikraft/unikraft/issues/new?assignees=&labels=kind%2Fbug&projects=&template=bug_report.yml">Report Bug</a> · <a href="https://github.com/unikraft/unikraft/issues/new?assignees=&labels=kind%2Fenhancement&projects=&template=project_backlog.yml">Feature Request</a> · <a href="https://unikraft.org/discord">Join Our Discord</a> · <a href="https://x.com/UnikraftSDK">X.com</a> </p> <br /> <div align="center"> <img src="https://unikraft.org/assets/imgs/monkey-business.gif" width="80%" /> </div> <br />

Features

Instantaneous Cold-boots ⚡
- While Linux-based systems might take tens of seconds to boot, Unikraft will be up in milliseconds.
Modular Design 🧩
- Unikraft boasts a modular design approach, allowing developers to include only necessary components, resulting in leaner and more efficient operating system configurations.
Optimized for Performance 🚀
- Built for performance, Unikraft minimizes overheads and leverages platform-specific optimizations, ensuring applications achieve peak performance levels.
Flexible Architecture Support 💻
- With support for multiple hardware architectures including x86, ARM, (and soon RISC-V), Unikraft offers flexibility in deployment across diverse hardware platforms.
Broad Language and Application Support 📚
- Unikraft offers extensive support for multiple programming languages and hardware architectures, providing developers with the flexibility to choose the tools and platforms that best suit your needs.
Cloud and Edge Compatibility ☁️
- Designed for cloud and edge computing environments, Unikraft enables seamless deployment of applications across distributed computing infrastructures.
Reduced Attack Surface 🛡️
- By selectively including only necessary components, Unikraft reduces the attack surface, enhancing security in deployment scenarios. Unikraft also includes many [additional modern security features][unikraft-security-features].
Developer Friendly 🛠️
- Unikraft's intuitive toolchain and user-friendly interface simplify the development process, allowing developers to focus on building innovative solutions.
Efficient Resource Utilization 🪶
- Unikraft optimizes resource utilization, leading to smaller footprints (meaning higher server saturation) and improved efficiency in resource-constrained environments.
Community-Driven Development 👥
- Unikraft is an open-source project driven by a vibrant community of over 100 developers, fostering collaboration and innovation from industry and academia.

Quick Start

Install the companion command-line client [kraft][kraft]:

# Install on macOS, Linux, and Windows:
curl -sSfL https://get.kraftkit.sh | sh

See [additional installation instructions][unikraft-cli-install].

Run your first ultra-lightweight unikernel virtual machine:

kraft run unikraft.org/helloworld:latest

View its status and manage multiple instances:

kraft ps --all

View the community image catalog in your CLI for more apps:

kraft pkg ls --update --apps

Or browse through one of the many [starter example projects][unikraft-catalog-examples].

Why Unikraft?

Unikraft is a radical, yet Linux-compatible with effortless tooling, technology for running applications as highly optimized, lightweight and single-purpose virtual machines (known as unikernels).

In today's computing landscape, efficiency is paramount. Unikraft addresses this need with its modular design, enabling developers to create customized, lightweight operating systems tailored to specific application requirements. By trimming excess overhead and minimizing attack surfaces, Unikraft enhances security and performance in cloud and edge computing environments.

Unikraft's focus on optimization ensures that applications run smoothly, leveraging platform-specific optimizations to maximize efficiency. With support for various hardware architectures and programming languages, Unikraft offers flexibility without compromising performance. In a world where resources are precious, Unikraft provides a pragmatic solution for streamlined, high-performance computing.

Getting Started

There are two ways to get started with Unikraft:

(Recommended) Using the companion command-line tool [kraft][kraft] (covered below).
Using the GNU Make-based system. For this, see our [advanced usage guide][unikraft-guides-advanced].

Toolchain Installation

You can install the companion command-line client [kraft][kraft] by using the interactive installer:

# Install on macOS, Linux, and Windows:
curl -sSfL https://get.kraftkit.sh | sh

macOS

brew install unikraft/cli/kraftkit

Debian/Fedora/RHEL/Arch/Windows

Use the interactive installer or see [additional installation instructions][unikraft-cli-install].

Codespaces

Try out one of the examples in GitHub Codespaces:

[][github-codespaces-catalog]

Container Build Environment

You can use the pre-built development container environment which has all dependencies necessary for building and trying out Unikraft in emulation mode.

Attach your working directory on your host as a mount path volume mapped to /workspace, e.g.:

docker run --platform linux/x86_64 -it --rm -v $(pwd):/workspace --entrypoint bash kraftkit.sh/base:latest

The above command will drop you into a container shell. Type exit or <kbd>Ctrl</kbd>+<kbd>D</kbd> to quit.

Testing your Installation

Running unikernels with kraft is designed to be simple and familiar. To test your installation of kraft, you can run the following:

kraft run unikraft.org/helloworld:latest

Build your first unikernel

Building unikernels is also designed to be straightforward. Build your first unikernel by simply placing a Kraftfile into your repo and pointing it to your existing Dockerfile:

spec: v0.6

runtime: base:latest

rootfs: ./Dockerfile

cmd: ["/path/to/my-server-app"]

Learn more about the [syntax of a Kraftfile][unikraft-kraftfile-syntax].

Once done, invoke in the context of your working directory:

kraft run .

Example Projects and Pre-built Images

You can find some common project examples below:

Find [more examples and applications in our community catalog][unikraft-catalog]!

Cloud Deployment

The creators of Unikraft have built KraftCloud: a next generation cloud platform powered by technology intended to work in millisecond timescales.

| ✅ | Millisecond Scale-to-Zero | ✅ | Millisecond Autoscale | ✅ | Millisecond Cold Boots | |:-|:-|:-|:-|:-|:-| | ✅ | Higher Throughput | ✅ | Much Lower Cloud Bill | ✅ | HW-Level Isolation | | ✅ | On-Prem or Cloud-Prem | ✅ | Works with Docker & K8s | ✅ | Terraform Integration |

Unikraft

Install / Use

README