BKR-LABCONTROLLER-CREATE(1)

📦
version 29.2 · 3 versions
, in epel 9

💅 bkr-labcontroller-create — create a new lab controller (yes bestie, another one)

okay so this is a Beaker manual page, section 1, and it's about the bkr labcontroller-create command. it does exactly one (1) thing and honestly it ate: it spins up a brand-new Lab controller in your Beaker setup. no cap. 🎀

✨ SYNOPSIS ✨

bkr labcontroller-create [options]
  --fqdn <fqdn>
  --user <username>
  [--password <password>]
  --email <email_address>

like, that's the whole vibe. three of those are mandatory, one's optional (iykyk which one 👀).

🌸 DESCRIPTION 🌸

Creates a new Lab controller. that's it. that's the sentence. iconic brevity, lowkey. 🦋

💖 OPTIONS 💖

  • --fqdn <fqdn> — sets the lab controller's FQDN. its whole government name, basically. 👑
  • --user <username> — sets the username for the lab controller's user account. heads up though: the lab controller itself has to be configured to authenticate as this username. it's giving "matching outfits or it doesn't count" 🫶
  • --password <password> — sets the password for the lab controller's user account, if you're doing password-based authentication. again, the lab controller must be configured to use this password for authentication. and listen — if your Beaker site is using Kerberos authentication, omit this option. literally just leave it out, bestie, don't do it to yourself 🙈
  • --email <email_address> — sets the email address for the lab controller's user account. contact info era. ✨
also! the common bkr options live in the Options section of bkr(1) — go read that one too, it's the group chat everyone's in. 💬

🔥 EXIT STATUS 🔥

Non-zero on error, otherwise zero. so: 0 = slay, anything else = something's wrong, check the vibe. 💀

🍓 EXAMPLES 🍓

Create a Lab controller lab1.fqdn.name:

   bkr labcontroller-create         --fqdn lab1.fqdn.name         --user host/lab1.fqdn.name         --password lc1         --email user@lab1.fqdn.name

(those big gaps of spaces? yeah they're in the original, we don't edit the source material 💅)

🧚 SEE ALSO 🧚

  • bkr labcontroller-list(1) — for when you've created so many you've lost track, which, valid. 🌈

⭐ AUTHOR ⭐

The Beaker team <beaker-devel@lists.fedorahosted.org> — the main characters, fr fr.

2013-2025 Red Hat, Inc.

and that's the page!! 🦋 this was bkr-labcontroller-create(1) from Beaker, version 29.2, dated May 26, 2025 — mwah, go create some lab controllers, you've got this 🫶💖

📦 where this page comes from