ROCM-QEMU-CREATE(8)

💖 ROCM-QEMU-CREATE 💖

okay bestie, so this is rocm-qemu-create — a System Administration Utilities girlie, section 8 of the manual, and she is here to spin up a whole entire VM for you. no cap. let's get into it 🫶

---

✨ NAME ✨

rocm-qemu-create — literally just rocm-qemu-create. that's the whole name, she's lowkey humble like that 💅

---

🌸 DESCRIPTION 🌸

so what she does is create a QEMU VM that's suitable for running ROCm package autopkgtests. main character energy, nothing less 👑

one thing to know: IMAGE, if you don't specify it, defaults to RELEASE.img. periodt.

this script will build an EFI-bootable image IMAGE, with the packages firmware-amd-graphics and openssh-server preinstalled, and (optionally) other minor customizations. it's giving ✨prepared✨.

the image will have a regular (non-system) user 'user', who will be in all the necessary system groups. she's got the right memberships, fr fr.

and yesss — you will be able to share a host directory with the guest. it's giving teamwork 🌈

📜 Synopsis:

bin/rocm-qemu-create -h

bin/rocm-qemu-create [-a AKFILE] [-m MIRROR] [-r RELEASE] [IMAGE]

---

🎀 OPTIONS 🎀

• -h — show this help. that's it, that's the option, she's helpful like that 💖
• -a AKFILE — file to copy to /root/.ssh/authorized_keys and to /home/rocm/.ssh/authorized_keys in the guest. yes, both of them. no cap 🔑
• -m MIRROR — download packages from here. this will be also used within the image. ideally, this points to an APT cache on the host machine, such as apt-cacher-ng or approx. mirror girlies stay winning 🪞✨
• -r RELEASE — release (default: 'unstable'). okay so if RELEASE is 'experimental', APT sources for both 'unstable' and 'experimental' will be added to the image. and if RELEASE contains a dash, APT sources for the "basename" will be added, e.g.: 'bookworm-backports' will include sources for 'bookworm' and 'bookworm-backports'. the dash is doing so much work and she's iconic for it 💅

---

🌟 EXAMPLES 🌟

# Configure the system for GPU pass-through

$ rocm-qemu-setup -u <user>

setting up the system for GPU pass-through first, obviously 💜

# Creates unstable.img based on unstable

$ sudo bin/rocm-qemu-create

creates unstable.img based on unstable. the default girlie 🦋

# Same image as above, but named unstable-autopkgtest-amd64.img

$ sudo bin/rocm-qemu-create unstable-autopkgtest-amd64.img

same image as above, but named unstable-autopkgtest-amd64.img. name change only, she's still her 🌸

# Create unstable.img using the mirror at 10.1.2.3:9999, which
# ideally # is a local APT cache

$ sudo bin/rocm-qemu-create -m http://10.1.2.3:9999/debian

create unstable.img using the mirror at 10.1.2.3:9999, which ideally is a local APT cache. support your local cache, bestie 🫶

# Creates bookworm.img

$ sudo bin/rocm-qemu-create -r bookworm

creates bookworm.img 🐛📚

# Copies this file to {/root,/home/rocm}/.ssh/authorized_keys

$ sudo bin/rocm-qemu-create -a ~/.ssh/id_rsa.pub

copies this file to {/root,/home/rocm}/.ssh/authorized_keys. ssh keys in, vibes up ✨

---

ok one lil reminder bestie: every single one of these is run with sudo, k? don't forget or she won't be able to do her thing 😭

---

and that's the whole page!! 💖 this lil number came straight from the debian crew, dated July 2026 — yeah, we're reading from the future, slay ⭐ thanks for reading all the way to the end, ily, go build a VM 🎀👑