fakemachine(1)

🌸 NAME 🌸

fakemachine — fake a machine 💅

Creates a virtual machine based on the currently running system. Like, it literally takes the system you're on right now and goes "okay bestie, you're a VM now" ✨

---

✨ SYNOPSIS ✨

fakemachine [options] <command to run inside machine>
fakemachine [--help]

So you either hand it a <command to run inside machine> and some options, or you just ask for --help and dip 🙈

---

💖 Application Options 💖

• -b, --backend=[auto|kvm|uml|qemu] — which virtualisation backend to use. Default is auto, so it picks for you (main character energy tbh) 👑
• -v, --volume= — a volume to mount 📁
• -i, --image= — an image to add 🖼️
• -e, --environ-var= — environment variables, and yes you use the -e VARIABLE:VALUE syntax, colon between them, no cap 🫶
• -m, --memory= — how much memory the fakemachine gets, measured in megabytes 🧠
• -c, --cpus= — how many CPUs the fakemachine gets ⚡
• -s, --scratchsize= — on-disk scratch space size, with a unit suffix, e.g. 4G. If you don't set it, scratch space is memory backed instead 🍓
• --show-boot — show boot/console messages from the fakemachine, for when you wanna watch the whole thing come alive 👀

🎀 Help Options 🎀

• -h, --help — show this help message 💖

---

📦 INSTALLATION 📦

$ export GOPATH=~/go
$ export PATH=$PATH:~/go/bin
$ go install github.com/go-debos/fakemachine/cmd/fakemachine@latest

---

🌈 USAGE 🌈

$ fakemachine echo test
Running echo test using kvm backend
test

Look at her go 😭 it told us it's running echo test using the kvm backend and then it just... did it. Iconic.

---

And that's the whole page, bestie 🦋 — this was fakemachine(1), the manual for fakemachine(1) from the fakemachine source, dated like every good manual page is. Go spin up a fake machine, you got this 💜✨