KRUNVM-CREATE(1)

✨ KRUNVM-CREATE ✨

okay bestie, so this is the krunvm-create page from the krunvm manual (section 1, the commands section, where all the good stuff lives 💅) and it's literally just: make a new microVM out of an OCI image. that's the whole vibe. let's get into it 🫶

---

🌸 NAME 🌸

krunvm-create — create a new microVM from an OCI image ✨

like. it makes a microVM. from an image. no cap.

---

🎀 SYNOPSIS 🎀

krunvm create [OPTIONS] IMAGE

that's it, that's the summoning ritual 🔮

---

💖 DESCRIPTION 💖

so krunvm create creates a new microVM from the OCI image you hand it in the IMAGE argument. 🦋

and if you're like "bestie what even counts as an IMAGE around here" — please go read buildah-from(1), it explains the format that IMAGE supports. i'm not gatekeeping, i'm just saying the format lore lives over there 📖✨

---

👑 OPTIONS 👑

• --cpus NUM — the number of vCPUs that get created for this microVM. more cpus = more main character energy, but also like, be reasonable 🫶
• --mem NUM — the amount of RAM, in MiB, that will be available to this microVM. 🧠

and here's the cute part: the memory you configure for the microVM is not reserved immediately. instead it gets provided as the guest demands it, and both the guest and libkrun (which is acting as the Virtual Machine Monitor) will attempt to return as many pages as possible back to the host. so it's giving generous-but-tidy, not hoarder ✨

• --name NAME — the name to be assigned to this microVM. give it a name, it deserves one 🥺
• -p, --port HOST_PORT:GUEST_PORT — exposes a port in the guest running in the microVM through a port in the host. 🌈

you can specify this option multiple times to expose as many guest ports as you want. go off, expose them all 💅

• -v, --volume HOST_PATH:GUEST_PATH — makes HOST_PATH visible in the guest running in the microVM through GUEST_PATH. 📁

this option can also be specified multiple times to make more paths in the host visible in the guest. stack 'em up 🧚

• -w, --workdir GUEST_PATH — configures GUEST_PATH as the working directory for the first binary executed in the microVM. like, where the whole thing kicks off 🎬

---

🔥 SEE ALSO 🔥

buildah(1), buildah-from(1), krunvm(1), krunvm-changevm(1)

(go read these, they're the extended universe iykyk 📚)

---

ok real talk bestie, quick vibe check on the whole thing: krunvm create [OPTIONS] IMAGE is the move, every flag above is exact, and the memory thing is lazy on purpose — that's a feature, not a bug, don't panic 💖

and that's the page!! this version is from the krunvm manual, dated 2025-07-25, and the header/footer both say KRUNVM-CREATE(1) because that's literally the name of the page bestie 😭💜 slay, go build a tiny VM, mwah 🎀✨