ujust Commands#
This guide covers the available ujust commands for Bluefin users. For more details and curated application bundles, see the Bluefin Common repository and the Brewfiles documentation.
System Commands#
| Command | Description |
|---|---|
| rebase-helper | Runs the rebase assistant via /usr/bin/ublue-rollback-helper. Prompts you to select from available Bluefin image variants (e.g., bluefin, bluefin-dx, bluefin-nvidia-open, bluefin-dx-nvidia-open). Assists with rebasing your system to the chosen image flavor. |
| bluefin-cli | Installs the Bluefin CLI tools and utilities. Uses Homebrew to install all packages listed in cli.Brewfile. For a full list of included CLI tools, see the Brewfiles section. |
| toggle-tpm2 | Toggles automatic LUKS unlocking via TPM2. Launches an interactive script to enable or disable TPM2-based auto-unlock for your encrypted disk. Supports optional PIN setup and uses systemd-cryptenroll. For more details, see the GNOME OS TPM2 unlock guide, Fedora TPM2 unlock discussion, and LUKS2 TPM2 blog post. |
| toggle-user-motd | Toggles the display of the Bluefin MOTD banner for your user. Creates or removes $HOME/.config/no-show-user-motd to enable or disable the banner on shell startup. See Ask Bluefin: MOTD Banner for details. |
| clean-system | Cleans up unused system resources: prunes all Podman and Docker images/volumes (with confirmation), removes unused Flatpaks, runs rpm-ostree cleanup -bm, and performs Homebrew cleanup if installed. Useful for reclaiming disk space and keeping the system tidy. See Ask Bluefin: clean-system for details. |
| powerwash | Performs a factory reset using sudo bootc install reset --experimental. Experimental: erases all user data and returns the system to factory state. Presents two confirmation dialogs (both default to "No") to prevent accidental data loss. For technical details and risks, see the bootc experimental install reset documentation. |
App Commands#
| Command | Description |
|---|---|
| jetbrains-toolbox | Alias for install-jetbrains-toolbox. Installs JetBrains Toolbox. |
| install-jetbrains-toolbox | Downloads and installs the latest JetBrains Toolbox, verifies the checksum, extracts, moves to the user's local share directory, and launches the app. |
| install-opentabletdriver | Installs or uninstalls OpenTabletDriver with an interactive prompt. On install, downloads the latest release, sets up udev rules, blacklists conflicting kernel modules (hid_uclogic, wacom), installs the Flatpak from Flathub, configures Flatpak filesystem overrides for $HOME/.config/OpenTabletDriver, and enables the user systemd service. On uninstall, removes udev rules, cleans up kernel arguments, and uninstalls the Flatpak. Requires privilege escalation for system changes. For more details, see the OpenTabletDriver documentation and Flathub package page. |
| install-gaming-flatpaks | Installs gaming-related Flatpak apps and runtimes (Steam, Heroic Games Launcher, Lutris, ProtonPlus, etc.) from Flathub. |
| bbrew | Installs applications from curated Brewfiles. When you run ujust bbrew, you'll see a note: "Note: Some of these take a while to load, we'll keep working on it." before the Brewfile selector appears. Select from available bundles, including the Swift development environment (swift). See the Brewfiles section for details and package lists. |
Brewfiles#
Available Brewfiles:
| Brewfile | Type | Description |
|---|---|---|
full-desktop.Brewfile | Flatpak | Comprehensive collection of GNOME Circle and community Flatpak applications for a full desktop experience |
fonts.Brewfile | Brew | Additional monospace fonts for development |
cli.Brewfile | Brew | CLI tools and utilities |
ai-tools.Brewfile | Brew, Flatpak | AI and machine learning tools, including CLI and cask applications for popular AI models and chat clients. Now includes Jan (Flathub), an Apache 2.0 licensed local AI chat client. |
cncf.Brewfile | Brew, Flatpak | Cloud Native Computing Foundation tools, including CLI utilities, Flatpaks for graphical tools (e.g., Headlamp, OpenLens, Podman Desktop), and extensive tap management. See CNCF Brewfile for details and comments on formula availability. |
k8s-tools.Brewfile | Brew | Kubernetes CLI tools and helpers |
ide.Brewfile | Brew | Integrated development environments (IDEs) and editors, including Visual Studio Code, VSCodium, JetBrains Toolbox for Linux, and popular editors such as Neovim (nvim), Micro, and Helix. Also includes Dev Container CLI support. |
artwork.Brewfile | Brew | Design and artwork applications, including curated wallpaper packs and design tools |
experimental-ide.Brewfile | Brew | Experimental IDEs and editors for Linux, including JetBrains IDEs, Cursor, Antigravity, and more, from the experimental tap |
swift.Brewfile | Brew | Swift development environment: official toolchain manager, code style enforcement, and formatting tools |
To install a curated bundle:
ujust bbrew # Select from the available Brewfiles (e.g., full-desktop, swift, ide)
When you run ujust bbrew, you'll see a note about loading times before the selector appears. This is normal—some bundles may take a moment to load.
For more details, see the Brewfiles documentation and the Brewfile directory. For CNCF and Kubernetes tools, see the CNCF Brewfile reference for up-to-date lists, taps, and Flatpak integrations.
IDE Brewfile Reference#
The IDE Brewfile provides a curated set of IDEs and editors for development:
| Package | Purpose |
|---|---|
visual-studio-code-linux | Visual Studio Code for Linux |
vscodium-linux | VSCodium (open-source VS Code build) |
jetbrains-toolbox-linux | JetBrains Toolbox for Linux |
nvim | Neovim, a modern Vim-based editor |
micro | Micro, a terminal-based text editor |
helix | Helix, a post-modern modal text editor |
devcontainer | Dev Container CLI support |
Usage Example:
ujust bbrew # Select "ide" from the list
For the latest package list, see the IDE Brewfile.
Swift Brewfile Reference#
The Swift Brewfile provides a curated set of tools for Swift development:
| Package | Purpose |
|---|---|
swiftly | Official Swift toolchain manager from swift.org |
swiftlint | Enforce Swift style and conventions |
swiftformat | Automatic code formatting |
Usage Example:
ujust bbrew # Select "swift" from the list
swiftly install latest # Install the Swift compiler
For more information on Swift development with Bluefin, see Ask Bluefin: Swift Environment. Refer to the Swift Brewfile for the latest package list.
Image and ISO Commands#
| Command | Description |
|---|---|
| build | Builds a Bluefin container image with options for rechunking, pushing to GHCR, pipeline integration, and kernel pinning. |
| build-rechunk | Builds the image and then rechunks it, combining both steps. |
| build-ghcr | Builds the image with the GHCR flag (requires root). |
| build-pipeline | Builds the image with pipeline integration (requires sudo if not root). |
| rechunk | Runs the rechunker container to prune, create the ostree tree, chunk the image, and clean up. |
| load-rechunk | Loads an OCI image into the Podman store after validation and cleanup. |
| run | Runs a Bluefin container image interactively, building it first if needed. |
| build-iso | Builds an ISO image for Bluefin, prepares Flatpak lists, and runs a containerized ISO builder. |
| build-iso-ghcr | Builds an ISO using a GHCR image by calling build-iso with a flag. |
| run-iso | Runs the Bluefin ISO in a QEMU container, with port forwarding and VM environment setup. |
Utility and Admin Commands#
| Command | Description |
|---|---|
| changelogs | Shows changelogs for each package since the last update. For stable or GTS tags, fetches from GitHub releases; otherwise, uses rpm-ostree changelogs. Output includes Author, commit hash, and subject. |
| changelogs-fedora | Shows rpm-ostree changelogs specifically for Fedora. |
| verify-container | Verifies container images using cosign and public keys. |
| secureboot | Checks secure boot signatures of the kernel using sbverify and public certificates. |
| fedora_version | Retrieves the Fedora version label from a Bluefin image, optionally using a kernel pin. |
| image_name | Returns the image name based on image, tag, and flavor parameters. |
| generate-build-tags | Generates build tags for images based on tag, flavor, version, and GitHub event context. |
| generate-default-tag | Determines the default tag for an image based on the tag and GHCR flag. |
| tag-images | Tags a built image with multiple tags and handles special tagging for HWE images. |
| retag-nvidia-on-ghcr | Retags Nvidia-open related Bluefin images on GHCR, optionally as a dry run. |
Update Commands#
| Command | Description |
|---|---|
| toggle-updates ACTION="prompt" | Turns automatic updates on or off. Detects the current state and enables/disables the uupd.timer systemd timer. Disables conflicting update timers when enabling. |
Note: Update-related commands are now provided by the common OCI base. The
updatecommand is no longer defined locally and may differ from previous behavior. Refer to upstream documentation for details on update workflows.
Custom Recipes#
You can add your own custom just recipes by placing a 60-custom.just file in /usr/share/ublue-os/just/. If present, this file will be automatically and optionally imported, allowing you to extend or override commands without modifying the base justfiles.
For more information, see the Bluefin documentation and the Bluefin Common repository. For curated application bundles, refer to the Brewfiles section. All extra application installations should use the ujust bbrew workflow.
For the most up-to-date list of available editors and IDEs, always refer to the IDE Brewfile in the Bluefin Common repository.
If you have questions or want to dig deeper, check out Ask Bluefin for community Q&A and more docs.
Stay curious, stay caffeinated, and let the scripts do the heavy lifting!
