BKR-SYSTEM-PROVISION(1)

💅 BKR-SYSTEM-PROVISION(1) — the Beaker girlies' guide

okay so bestie, welcome to bkr-system-provision, part of the Beaker manual set. this is the one that provisions a Beaker system for you, and yes i'm gonna walk you through every single flag because i'm not about to let you fumble this 🫶

✨ NAME ✨

bkr-system-provision — provision a Beaker system. that's it, that's the vibe. 💖

🦋 SYNOPSIS 🦋

bkr system-provision [options]
  [--ks-meta <variables>]
  [--kernel-options <opts>]
  [--kernel-options-post <opts>]
  [--kickstart <file>]
  [--no-reboot]
  --distro-tree <id>
  <fqdn>

like, look at her. she's got options, she's got a required --distro-tree <id>, she's got an <fqdn> at the end. main character energy fr fr 👑

🌸 DESCRIPTION 🌸

provisions the given system with the given distro. pass extra options to customise the OS installation — that's the whole bit, no cap. ✨

⚠️ vibe check first, bestie: the system must have its status set to Manual and be already reserved by the current user. no reservation, no provisioning. periodt.

and if you were hoping to provision a system using the Beaker scheduler instead? different quest, babe — submit a job using the Beaker web UI or a workflow command (such as bkr workflow-simple) instead. 😌

---

🎀 OPTIONS 🎀

• --distro-tree <id> — provision the distro tree identified by <id>. this one's required, bestie, don't forget her. 💅

the distro tree id can be found in Beaker's web UI, or by using bkr distro-trees-list. iykyk 🔍

• --ks-meta <variables> — pass additional kickstart metadata <variables> to Cobbler. the variables string is applied on top of any variables which are set by default for the chosen system and distro. so like, layers on layers 🧚
• --kernel-options <opts> — pass additional kernel options for during installation. the options string is applied on top of any install-time kernel options which are set by default for the chosen system and distro. ✨
• --kernel-options-post <opts> — pass additional kernel options for after installation. the options string is applied on top of any post-install kernel options which are set by default for the chosen system and distro. lowkey the sequel to the one above 🦋
• --kickstart <file> — pass <file> as the kickstart for installation. if <file> is -, the kickstart is read from stdin. cute, right? 📥

🙈 heads up: the kickstart must be a complete kickstart (not just a snippet). Beaker will not make any of the usual Beaker-related customisations to the kickstart; only the install location for the selected distro will be prepended to the top of the kickstart. so don't come crying to me when your snippet doesn't slay — it literally can't.

• --no-reboot — performs all the necessary steps to set up the system to be provisioned with the selected distro, but skips the final step of booting the system into the installation environment. 💀

if --no-reboot is passed, this command will have no effect unless a system is subsequently rebooted by using bkr system-power (or by some other means). yes queen, you have to actually finish the job yourself.

common bkr options are described in the Options section of bkr(1). go read her too, she's iconic 📖

---

⭐ EXIT STATUS ⭐

non-zero on error, otherwise zero. simple as that, no drama. 💅

🌈 EXAMPLES 🌈

reserve a particular system, provision it, do some work on it, and then release it — the full little ritual, bestie:

bkr system-reserve system1.example.invalid
bkr system-provision --kernel-opts "nogpt" \
                     --distro-tree 12345 \
                     system1.example.invalid
# do some work on the system
bkr system-release system1.example.invalid

see how it's a whole journey? reserve → provision → do the work → release. chef's kiss 🔥

🍓 HISTORY 🍓

prior to version 0.9.1, this command accepted --distro instead of --distro-tree. ancient lore, but now you know it 👑 (and no, don't try --distro now, she's retired)

💜 SEE ALSO 💜

bkr-workflow-simple(1), bkr-system-power(1), bkr(1) — the whole friend group, go say hi 🫶

🧚 AUTHOR 🧚

The Beaker team <beaker-devel@lists.fedorahosted.org> — legends, honestly 🌟

🎀 COPYRIGHT 🎀

2013-2025 Red Hat, Inc.

---

okay that's the whole page, you're officially educated 💖 this was Beaker manual page bkr-system-provision(1), version 29.2, dated May 26, 2025 — go forth and provision responsibly, bestie, and remember: reserve first, reboot last. mwah 😘✨