BKR-POOL-CREATE(1)

💅 bkr-pool-create — like, the manual page for bkr-pool-create(1)

okay bestie, welcome to the Beaker corner of the man pages 🧚 this one's about bkr-pool-create, and it's honestly so straightforward you're gonna slay it.

---

✨ NAME ✨

bkr-pool-create — create a system pool 🫶

---

✨ SYNOPSIS ✨

bkr pool-create [options] <poolname>
  [--description <description>]
  [--owning-group <groupname> | --owner <user>]

like, that's it. that's the whole vibe check. <poolname> is the main character, everything else is optional garnish 💅

---

🌸 DESCRIPTION 🌸

So bkr-pool-create creates a Beaker system pool. iconic behaviour, no cap ✨

By default the new pool is owned by the user who created it — very "you made it, you own it" energy, love that for you 💖. But if you wanna set a different owner, just use the --owning-group or --owner options and hand it off 🎀

🦋 New in version 20. (yes, it's a whole era, we stan)

---

👑 OPTIONS 👑

• --description <description> — sets the system pool's description. give your pool a little personality, bestie 💜
• --owning-group <groupname> — sets the owner of the system pool to group <groupname>. group project but make it official 🫶
• --owner <user> — sets the owner of the system pool to <user> instead of the currently logged in user. passing the crown to someone else, periodt 👑

also! the common bkr options are described in the Options section of bkr(1) — go check it out if you're nosy (i would be) 🙈

---

💀 EXIT STATUS 💀

Non-zero on error, otherwise zero. so like, zero means you ate, and anything else means something went sideways 😭

---

🌈 EXAMPLES 🌈

Wanna create a system pool called "beakerdevs"? say less:

bkr pool-create beakerdevs --description "Beaker developers"

And if you want that same "beakerdevs" pool but with the owner set to group "beakerdevs" (yes, same name, it's giving matching set 🎀):

bkr pool-create beakerdevs --owning-group beakerdevs

---

🔥 SEE ALSO 🔥

bkr(1) — the parent, the OG, the main character 🌟

---

🍓 AUTHOR 🍓

The Beaker team <beaker-devel@lists.fedorahosted.org> — love them, they made all this 💖

---

⭐ COPYRIGHT ⭐

2013–2025 Red Hat, Inc. 🧚

---

aaaand that's the page, bestie! shoutout to version 29.2, dated May 26, 2025 — that's the energy we're closing on 💅✨ go forth and create pools, you've got this 🦋🌸