ROCM-PODMAN-CREATE(1)

πŸ“¦
version 0.9.8ubuntu2 Β· 3 versions
, in ubuntu stonking

πŸ’… ROCM-PODMAN-CREATE

ok so bestie, this is a page from the User Commands manual, and it's all about rocm-podman-create. yes the name is literally the name, the manpage said so, we love a self-titled icon πŸ‘‘


✨ NAME ✨

rocm-podman-create β€” it's giving rocm-podman-create. that's it, that's the name, periodt πŸ’–


🌸 DESCRIPTION 🌸

So what this does is create a container image that's suitable for running ROCm package autopkgtests</hotpkgtests>… wait no, ROCm package autopkgtests. slay. πŸ”₯

If you don't specify IMAGE, it lowkey just defaults to rocm/debian:RELEASE. convenience queen πŸ‘‘

And the container? It comes with a regular (non-system) user called user, and that user is in all the necessary system groups. no cap, everything's already set up for you. 😭🫢

πŸ“œ Synopsis

bin/rocm-podman-create -h

bin/rocm-podman-create [-m MIRROR] [-r RELEASE] [-u USER] [IMAGE]

(yes -u USER shows up in the synopsis, that's canon, we don't make the rules πŸ’…)


πŸŽ€ OPTIONS πŸŽ€

  • -h β€” show this help. the classic. the icon. press it when you're lost 🧭
  • -m MIRROR β€” download packages from here. and like, it'll also be used within the image, so it's not a one-time thing, it sticks around. ideally this points to an APT cache on the host machine, like apt-cacher-ng or approx. it's giving efficient. it's giving fast. it's giving we're not redownloading the entire internet every time 🌈
  • -r RELEASE β€” the release, and the default is 'unstable' (bold choice, we respect it). so here's the tea:
    • if RELEASE is 'experimental', then APT sources for both 'unstable' and 'experimental' get added to the image. two for one, we ate πŸ’…
    • if RELEASE contains a dash, APT sources for the "basename" will be added. for example: 'bookworm-backports' will include sources for 'bookworm' and 'bookworm-backports'. see the pattern? basename gets pulled in too, no cap πŸ¦‹

⭐ EXAMPLES ⭐

bestie these are the actual commands, copy them exactly, don't freestyle:

# Configure the system for GPU-in-container use

$ rocm-podman-setup -u <user>

# Creates rocm/debian:unstable

$ bin/rocm-podman-create

# Same image as above, but tagged rocm/othertag

$ bin/rocm-podman-create rocm/othertag

# Creates rocm/debian:bookworm

$ bin/rocm-podman-create -m http://10.1.2.3:9999/debian -r
bookworm

see how the last one wraps onto the next line? that's just how it is, keep it. the bookworm goes on its own line, no notes πŸ™ˆ


ok that's literally the whole page. go build your container, you're the main character of this GPU pipeline πŸ‘‘

🌸 stay iconic, bestie 🌸

this gorgeous little page came from the debian source and it's dated July 2026 β€” mwah, no notes, iykyk πŸ’œ

πŸ“¦ where this page comes from