toolbox-enter(1)

💖 toolbox-enter(1) 💖

okay bestie, welcome to the General Commands Manual page for toolbox-enter — yes, the actual manpage, but make it make sense ✨

---

🌸 NAME 🌸

toolbox-enter — enter a Toolbx container for interactive use 🫶 like, you're literally stepping inside.

---

✨ SYNOPSIS ✨

toolbox enter [--distro DISTRO | -d DISTRO]
              [--release RELEASE | -r RELEASE]
              [CONTAINER]

that's it, that's the whole vibe 💅

---

🦋 DESCRIPTION 🦋

So what it does: it spawns an interactive shell inside a Toolbx container — one that you already made with the toolbox create command. She tries to spawn your default shell, but if that shell isn't available inside the container? no worries, she falls back to /bin/bash. iconic adaptability honestly.

When you invoke it with no options at all, toolbox enter will try to enter the default Toolbx container for the host. And if there's only one container available, then it'll just use that one. periodt. On Fedora, the default container is known as fedora-toolbox-N, where N is the release of the host. And if there aren't any containers at all?? toolbox enter will offer to create the default one for you 😭 so sweet of her.

You can also pick a specific container using the CONTAINER argument. main character energy, choosing your own destiny.

A Toolbx container is an OCI container. Which means toolbox enter is basically analogous to a podman start followed by a podman exec. iykyk 🔥

---

🎀 OPTIONS 🎀

the following options are understood, bestie, and there are exactly two of them, so no excuses:

• --distro DISTRO, -d DISTRO — enter a Toolbx container for a different operating system DISTRO than the host. ⚠️ It has to be coupled with --release unless the selected DISTRO matches the host. no solo runs allowed 💅
• --release RELEASE, -r RELEASE — enter a Toolbx container for a different operating system RELEASE than the host.

---

🌈 EXAMPLES 🌈

💜 Enter the default Toolbx container matching the host OS

$ toolbox enter

💜 Enter the default Toolbx container for Fedora 36

$ toolbox enter --distro fedora --release f36

💜 Enter a Toolbx container with a custom name

$ toolbox enter foo

---

⭐ SEE ALSO ⭐

go read these too, they're all in the family 🫶

• toolbox(1)
• toolbox-run(1)
• podman(1)
• podman-exec(1)
• podman-start(1)

---

okay that's the whole page, bestie 🍓 and yes, this is toolbox-enter(1) — the General Commands Manual entry itself, so you'll see that same name down at the bottom of the original like a little signature. consider this your cute sign-off instead 💖 mwah, go enter that container 👑