Create microVMs from OCI images
Go to file
Sergio López 21b9cb4760
Merge pull request #68 from stephen-fox/macos-only-map-volumes-if-required
start: Only map volumes if required on macOS
2025-06-16 16:07:10 +01:00
.github/workflows Run cargo clippy more times with each supported platform separately 2023-11-02 12:42:31 +01:00
docs add docs + change variable name 2024-02-06 20:09:29 +01:00
src start: Only map volumes if required on macOS 2025-06-13 21:00:53 +00:00
.gitignore chore: add Cargo.lock file 2021-03-20 00:07:36 +05:30
CODE-OF-CONDUCT.md Add Security and C-O-C docs 2021-04-20 09:27:45 -04:00
Cargo.lock Refactor argument parsing using new clap 4.x version 2023-11-02 19:35:50 +01:00
Cargo.toml Refactor argument parsing using new clap 4.x version 2023-11-02 19:35:50 +01:00
LICENSE initial commit 2021-01-27 15:32:37 +01:00
Makefile Makefile: Remove INIT_BINARY because there is no such thing 2023-10-04 10:38:21 +02:00
README.md README: Add asciidoctor dependency to building from source instructions 2023-10-04 10:54:39 +02:00
SECURITY.md Rename Security.md to SECURITY.md 2021-04-21 15:20:10 -04:00
build.rs Add manual pages 2022-07-05 13:12:21 +02:00
krunvm.entitlements initial commit 2021-01-27 15:32:37 +01:00

README.md

krunvm

krunvm is a CLI-based utility for creating microVMs from OCI images, using libkrun and buildah.

Features

  • Minimal footprint
  • Fast boot time
  • Zero disk image maintenance
  • Zero network configuration
  • Support for mapping host volumes into the guest
  • Support for exposing guest ports to the host

Demo

asciicast

Supported platforms

  • Linux/KVM on x86_64.
  • Linux/KVM on AArch64.
  • macOS/Hypervisor.framework on ARM64.

Installation

macOS

brew tap slp/krun
brew install krunvm

Fedora

dnf copr enable -y slp/libkrunfw
dnf copr enable -y slp/libkrun
dnf copr enable -y slp/krunvm
dnf install -y krunvm

Building from sources

Dependencies

Building

cargo build --release