### Run a Dev Container

Source: https://github.com/ublue-os/bluefin-docs/blob/main/docs/devcontainers.md

Command to start and run a dev container. This typically builds the container if it doesn't exist and then starts it.

```bash
devcontainer up .
```

--------------------------------

### Basic devcontainer.json Example

Source: https://github.com/ublue-os/bluefin-docs/blob/main/docs/devcontainers.md

A foundational devcontainer.json configuration for a Node.js environment, specifying the image, features, extensions, forwarded ports, and a post-creation command.

```json
{
  "name": "Node.js",
  "image": "mcr.microsoft.com/devcontainers/javascript-node:18",
  "features": {
    "ghcr.io/devcontainers/features/git:1": {}
  },
  "extensions": ["ms-vscode.vscode-typescript-next"],
  "forwardPorts": [3000],
  "postCreateCommand": "npm install"
}
```

--------------------------------

### Install Dev Container CLI

Source: https://github.com/ublue-os/bluefin-docs/blob/main/docs/devcontainers.md

Instructions for installing the Dev Container CLI using either Homebrew or npm. Homebrew is a package manager for macOS and Linux, while npm is the package manager for Node.js.

```bash
brew install devcontainer
```

```bash
npm install -g @devcontainers/cli
```

--------------------------------

### CI/CD Pipeline Dev Container Usage

Source: https://github.com/ublue-os/bluefin-docs/blob/main/docs/devcontainers.md

Example commands for integrating Dev Container CLI into a CI/CD pipeline. It demonstrates building the container and executing tests within it.

```bash
# In your CI pipeline
devcontainer build .
devcontainer exec . npm test
```

--------------------------------

### Verify Container Runtime with Podman or Docker

Source: https://github.com/ublue-os/bluefin-docs/blob/main/docs/devcontainers.md

Checks if the necessary container runtime (Podman or Docker) is installed and accessible from the command line.

```bash
# For Podman (default on Bluefin)
podman --version

# For Docker
docker --version
```

--------------------------------

### Build and Run Dev Container in One Command

Source: https://github.com/ublue-os/bluefin-docs/blob/main/docs/devcontainers.md

A convenience command that builds the dev container and then runs it, combining the build and up actions.

```bash
devcontainer up --build .
```

--------------------------------

### Install and Run Bold Brew

Source: https://github.com/ublue-os/bluefin-docs/blob/main/blog/2025-07-15-bold-brew.md

This snippet shows how to install the Bold Brew tool using a Homebrew tap and then how to run the tool. It's a simple two-step process for getting started with Bold Brew.

```shell
brew install Valkyrie00/homebrew-bbrew/bbrew
bbrew
```

--------------------------------

### Build a Dev Container

Source: https://github.com/ublue-os/bluefin-docs/blob/main/docs/devcontainers.md

Command to build a dev container from the current directory. This command reads the devcontainer.json configuration file to set up the development environment.

```bash
devcontainer build .
```

--------------------------------

### Dev Container Features for Git, GitHub CLI, and Node.js

Source: https://github.com/ublue-os/bluefin-docs/blob/main/docs/devcontainers.md

Demonstrates how to include pre-built Dev Container Features to add specific tools and runtime environments, such as Git, GitHub CLI, and Node.js, to a development container.

```json
{
  "features": {
    "ghcr.io/devcontainers/features/git:1": {},
    "ghcr.io/devcontainers/features/github-cli:1": {},
    "ghcr.io/devcontainers/features/node:1": {
      "version": "18"
    }
  }
}
```

--------------------------------

### Lifecycle Scripts for Container Automation

Source: https://github.com/ublue-os/bluefin-docs/blob/main/docs/devcontainers.md

Illustrates the use of lifecycle scripts within devcontainer.json to automate tasks during the container's creation, startup, and attachment phases.

```json
{
  "postCreateCommand": "npm install && npm run setup",
  "postStartCommand": "npm run dev",
  "postAttachCommand": "echo 'Container ready!'"
}
```

--------------------------------

### Install and Run Dev Server (npm)

Source: https://github.com/ublue-os/bluefin-docs/blob/main/README.md

Installs project dependencies using npm with legacy peer dependencies and starts the development server. The legacy-peer-deps flag is crucial for resolving React version conflicts.

```bash
npm install --legacy-peer-deps
npm run start
```

--------------------------------

### Install Neovim and Devcontainers via Homebrew

Source: https://github.com/ublue-os/bluefin-docs/blob/main/docs/bluefin-dx.md

Installs Neovim and devcontainer tools using the Homebrew package manager. This is a prerequisite for subsequent devcontainer setup instructions.

```bash
brew install neovim devcontainer
```

--------------------------------

### Install JetBrains Toolbox

Source: https://github.com/ublue-os/bluefin-docs/blob/main/docs/bluefin-dx.md

Fetches and installs the JetBrains Toolbox application, which manages the installation, removal, and upgrades of JetBrains products independently within the home directory.

```bash
ujust jetbrains-toolbox
```

--------------------------------

### Execute Commands in a Dev Container

Source: https://github.com/ublue-os/bluefin-docs/blob/main/docs/devcontainers.md

Command to execute a specific command within a running dev container. The example shows executing a bash shell.

```bash
devcontainer exec . bash
```

--------------------------------

### Multi-Container Development with Docker Compose

Source: https://github.com/ublue-os/bluefin-docs/blob/main/docs/devcontainers.md

Configures a dev container to use a docker-compose.yml file for managing multiple services, specifying the main service and workspace folder.

```json
{
  "name": "App with Database",
  "dockerComposeFile": "docker-compose.yml",
  "service": "app",
  "workspaceFolder": "/workspace"
}
```

--------------------------------

### Run Bluefin Container with Just

Source: https://github.com/ublue-os/bluefin-docs/blob/main/docs/local.md

Starts a Bluefin OS container from a previously built image using the 'just' tool. It specifies the image name and tag.

```bash
just run bluefin stable
```

--------------------------------

### Install Chezmoi via Homebrew

Source: https://github.com/ublue-os/bluefin-docs/blob/main/docs/installation.md

This command installs the chezmoi tool, a utility for managing dotfiles, using the Homebrew package manager. It's recommended for automating user-specific configuration.

```bash
brew install chezmoi
```

--------------------------------

### Creating a Bluefin USB Drive

Source: https://github.com/ublue-os/bluefin-docs/blob/main/docs/t2-mac.md

Instructions for creating a bootable USB drive for Bluefin OS installation using common command-line and graphical tools. This process is crucial for preparing the installation media.

```bash
dd if=/path/to/bluefin.iso of=/dev/sdX bs=4M status=progress oflag=sync
```

```text
Fedora Media Writer (Graphical Application)
```

```text
Similar tools like balenaEtcher or Ventoy can also be used.
```

--------------------------------

### Install Ramalama via Homebrew

Source: https://github.com/ublue-os/bluefin-docs/blob/main/docs/bluefin-dx.md

Installs Ramalama using Homebrew for local management and serving of AI models. Refer to the AI documentation for further details.

```bash
brew install ramalama
```

--------------------------------

### Launch Games with MangoHud

Source: https://github.com/ublue-os/bluefin-docs/blob/main/docs/gaming.md

Example of how to launch a game with MangoHud using a command-line argument. This is commonly used in game launchers like Steam.

```bash
mangohud %command%
```

--------------------------------

### Launch Games with OBS VkCapture

Source: https://github.com/ublue-os/bluefin-docs/blob/main/docs/gaming.md

Example of adding a launch command to capture games with OBS using the OBS VkCapture plugin. This is useful for recording Vulkan and OpenGL games.

```bash
obs-gamecapture %command%
```

--------------------------------

### Install Bluefin CLI Tools

Source: https://github.com/ublue-os/bluefin-docs/blob/main/docs/command-line.md

Installs Bluefin's opt-in command line experience, which includes various modern CLI tools like atuin, carapace, direnv, eza, fd, fzf, ripgrep, tealdeer, television, trash-cli, ugrep, uutils, yq, and zoxide. Rerunning this command will update to the latest versions of these tools.

```bash
ujust bluefin-cli
```

--------------------------------

### Install Gaming Flatpaks

Source: https://github.com/ublue-os/bluefin-docs/blob/main/docs/gaming.md

Command to install essential gaming Flatpaks on Bluefin OS. This command installs a suite of gaming tools without requiring a system reboot.

```bash
ujust install-gaming-flatpaks
```

--------------------------------

### Enable iGPU for Hybrid Graphics on T2

Source: https://github.com/ublue-os/bluefin-docs/blob/main/docs/t2-mac.md

Configuration to enable the integrated GPU (iGPU) for hybrid graphics setups on T2 systems. This involves creating a specific configuration file to manage graphics switching.

```bash
if [[ -f /etc/modprobe.d/apple-gmux.conf ]]; then
  # Uncomment the options line if it exists
  sed -i 's/^#\(options apple_gmux \)/\1/' /etc/modprobe.d/apple-gmux.conf
else
  # Create the file if it doesn't exist (though the guide implies it should)
  echo "options apple_gmux" | sudo tee /etc/modprobe.d/apple-gmux.conf
fi
```

--------------------------------

### Run Development Container (Docker)

Source: https://github.com/ublue-os/bluefin-docs/blob/main/README.md

Starts the development environment using Docker Compose. This command assumes a docker-compose.yml file is present in the project root.

```bash
docker compose up
```

--------------------------------

### Run Gamescope Microcompositor

Source: https://github.com/ublue-os/bluefin-docs/blob/main/docs/gaming.md

Example command to run Gamescope, a microcompositor from Valve. It's used to spoof screen resolutions and is run as a runtime from the command line.

```bash
flatpak run runtime/org.freedesktop.Platform.VulkanLayer.gamescope /path/to/your/executable
```

--------------------------------

### Install T2-specific Packages

Source: https://github.com/ublue-os/bluefin-docs/blob/main/docs/t2-mac.md

Installs essential T2-specific packages for Bluefin OS, including fan control (t2fanrd), touchbar management (rust-tiny-dfr), and audio support (t2linux-audio). A reboot is required after installation.

```bash
sudo dnf install t2fanrd rust-tiny-dfr t2linux-audio
```

--------------------------------

### Clean Build Artifacts with Just

Source: https://github.com/ublue-os/bluefin-docs/blob/main/docs/local.md

Removes build directories and manifest files from the repository using the 'clean' task in the Justfile. This is useful for freeing up disk space and starting fresh.

```bash
just clean
```

--------------------------------

### Conventional Commits Examples

Source: https://github.com/ublue-os/bluefin-docs/blob/main/docs/contributing.md

Examples of commit messages following the Conventional Commits specification for various types of changes, including chore, docs, feat, fix, refactor, style, and test.

```git
chore: add Oyster build script
docs: explain hat wobble
feat: add beta sequence
fix: remove broken confirmation message
refactor: share logic between 4d3d3d3 and flarhgunnstow
style: convert tabs to spaces
test: ensure Tayne retains clothing
```

--------------------------------

### Install Audio DSP dependencies for Bluefin-OS

Source: https://github.com/ublue-os/bluefin-docs/blob/main/docs/t2-mac.md

Installs necessary audio dependencies, including Calf plugins and PipeWire filter chain modules, to enable tuned software DSP for improved audio quality on MacBook Pro 16".

```bash
sudo dnf install calf libspatialaudio lsp-plugins-lv2 lv2-calf-plugins ladspa-swh-plugins pipewire-module-filter-chain-lv2
```

--------------------------------

### Add User to DX Groups

Source: https://github.com/ublue-os/bluefin-docs/blob/main/docs/bluefin-dx.md

This command adds the current user to the necessary groups for Developer Mode functionality on Bluefin OS. This is a one-time setup step and requires a reboot afterward.

```bash
ujust dx-group
```

--------------------------------

### Rebase to Unsigned Bluefin Image

Source: https://github.com/ublue-os/bluefin-docs/blob/main/docs/t2-mac.md

Rebases the system to an unsigned Bluefin image. This is a preparatory step before rebasing to a signed, custom image for T2 Macs. Requires specifying the repository and image tag.

```bash
sudo bootc switch ghcr.io/[repo/bluefin-package:tag]
```

--------------------------------

### Configure apple-bce module for T2 Linux initramfs

Source: https://github.com/ublue-os/bluefin-docs/blob/main/docs/t2-mac.md

Creates a configuration file to force the loading of the apple-bce module in the initramfs, ensuring keyboard functionality during early boot on T2 systems.

```bash
echo "force_drivers+=\" apple-bce \"" | sudo tee /etc/dracut.conf.d/t2linux-modules.conf
```

--------------------------------

### Pinning a package version with rpm-ostree

Source: https://github.com/ublue-os/bluefin-docs/blob/main/docs/contributing.md

This snippet demonstrates how to revert to an older version of ostree to fix Flatpak installations by using `rpm-ostree override replace`. This is useful for addressing regressions in upstream Fedora packages.

```bash
# Revert to older version of ostree to fix Flatpak installations
RUN rpm-ostree override replace https://bodhi.fedoraproject.org/updates/FEDORA-2023-cab8a89753
```

--------------------------------

### Check T2FanRD Service Status

Source: https://github.com/ublue-os/bluefin-docs/blob/main/docs/t2-mac.md

Checks the status of the t2fanrd service to ensure it is running correctly after installation. Fan speed curves can be customized by editing its configuration file.

```bash
systemctl status t2fanrd
```

--------------------------------

### Troubleshoot 'Cannot find module 'xml2js' Error

Source: https://github.com/ublue-os/bluefin-docs/blob/main/README.md

Provides steps to resolve the 'Cannot find module 'xml2js'' error, which typically arises from peer dependency conflicts during npm installation.

```bash
rm -rf node_modules
npm install --legacy-peer-deps
npm run start
```

--------------------------------

### Toggle Branches with ujust rebase-helper

Source: https://github.com/ublue-os/bluefin-docs/blob/main/blog/2025-09-18-bluefin-lts-and-gdx.md

This command allows users to switch between the standard Bluefin LTS and the hardware enablement (`hwe`) branches after installation. It facilitates easy management of kernel updates and hardware compatibility.

```bash
ujust rebase-helper
```

--------------------------------

### Add T2Linux Copr Repository

Source: https://github.com/ublue-os/bluefin-docs/blob/main/docs/t2-mac.md

Adds SharpenedBlade's T2Linux Copr repository for Fedora 40. This repository provides necessary packages for T2 Mac functionality on Bluefin OS.

```bash
sudo curl -o /etc/yum.repos.d/sharpenedblade-t2linux-fedora-40.repo https://copr.fedorainfracloud.org/coprs/sharpenedblade/t2linux/repo/fedora-40/sharpenedblade-t2linux-fedora-40.repo
```

--------------------------------

### Grant Steam Library Access

Source: https://github.com/ublue-os/bluefin-docs/blob/main/docs/gaming.md

Command to grant Flatpak access to an external Steam library directory. This is necessary for Steam to recognize games installed on drives other than the default.

```bash
flatpak override --user --filesystem=/path/to/your/Steam/Library com.valvesoftware.Steam
```

--------------------------------

### Append Kernel Arguments for T2 Macs

Source: https://github.com/ublue-os/bluefin-docs/blob/main/docs/t2-mac.md

Appends necessary kernel arguments to the system configuration for T2 Mac compatibility. These arguments are crucial for proper IOMMU and sleep state handling. A reboot is required for the changes to take effect.

```bash
rpm-ostree kargs --append-if-missing=intel_iommu=on --append-if-missing=iommu=pt --append-if-missing=mem_sleep_default=s2idle
```

--------------------------------

### Enable Tuned DSP Audio Configuration on T2-Atomic

Source: https://github.com/ublue-os/bluefin-docs/blob/main/docs/t2-mac.md

Enables the tuned DSP audio configuration for MacBookPro16,1 by renaming a disabled PipeWire configuration file. This improves sound quality on T2-Atomic images.

```bash
sudo mv /etc/pipewire/pipewire.conf.d/10-t2_161_speakers.confdisabled /etc/pipewire/pipewire.conf.d/10-t2_161_speakers.conf
```

--------------------------------

### Block T2 USB Ethernet Modules

Source: https://github.com/ublue-os/bluefin-docs/blob/main/docs/t2-mac.md

Blacklists the `cdc_ncm` and `cdc_mbim` kernel modules to prevent notifications from the T2 chip's internal USB Ethernet interface, which is not used in Linux.

```bash
echo "blacklist cdc_ncm
blacklist cdc_mbim" | sudo tee /etc/modprobe.d/t2-eth-blocklist.conf
```

--------------------------------

### Enable initramfs regeneration for early boot keyboard (LUKS)

Source: https://github.com/ublue-os/bluefin-docs/blob/main/docs/t2-mac.md

Enables initramfs regeneration to load the apple-bce module during early boot for LUKS unlock. This command modifies the system's initramfs configuration.

```bash
rpm-ostree initramfs enable
```

--------------------------------

### Overriding System Defaults with Custom Configuration

Source: https://github.com/ublue-os/bluefin-docs/blob/main/docs/administration.md

System defaults provided by Bluefin OS and Fedora are located in `/usr/etc`. These can be overridden by creating corresponding files in `/etc`. For example, to customize Distrobox configuration, create `/etc/distrobox/distrobox.ini` which will take precedence over `/usr/etc/distrobox/distrobox.ini`.

```Shell
# Example: Overriding Distrobox configuration
# Copy the default file for reference if needed:
# cp /usr/etc/distrobox/distrobox.ini /etc/distrobox/
# Then edit /etc/distrobox/distrobox.ini to apply your customizations.
```

--------------------------------

### Rebase to Signed Bluefin Image

Source: https://github.com/ublue-os/bluefin-docs/blob/main/docs/t2-mac.md

Rebases the system to a signed custom Bluefin image, ensuring signature policy compliance. This is the final step after rebasing to an unsigned image. Requires specifying the repository, image tag, and signature policy enforcement.

```bash
sudo bootc switch ghcr.io/[repo/bluefin-package-:tag --enforce-container-sigpolicy
```

--------------------------------

### Configure Systemd Login for T2 Lid Switch and Power Button

Source: https://github.com/ublue-os/bluefin-docs/blob/main/docs/t2-mac.md

Configures systemd's logind to ignore lid switches and set power button actions to 'poweroff' instead of 'suspend'. This prevents unwanted sleep behavior on T2 systems.

```bash
sudo mkdir -p /etc/systemd/login.conf.d
sudo touch /etc/systemd/login.conf.d/t2-lidswitch.conf

# Content for /etc/systemd/login.conf.d/t2-lidswitch.conf:
# [Login]
# HandlePowerKey=ignore
# HandlePowerKeyLongPress=poweroff
# HandleSuspendKey=ignore
# HandleSuspendKeyLongPress=poweroff
# HandleHibernateKey=ignore
# HandleHibernateKeyLongPress=poweroff
# HandleLidSwitch=ignore
# HandleLidSwitchExternalPower=ignore
# HandleLidSwitchDocked=ignore
```

--------------------------------

### Build Bluefin LTS Locally with Just

Source: https://github.com/ublue-os/bluefin-docs/blob/main/docs/lts.md

Instructions to clone the Bluefin LTS repository, build the VM image using `just build`, and create a qcow2 or ISO image. The qcow2 image is saved in the `output/` directory with default credentials 'centos'/'centos'.

```bash
git clone https://github.com/ublue-os/bluefin-lts
cd bluefin-lts
just build
just build-qcow2 ghcr.io/ublue-os/bluefin:lts # if you want to build an ISO just change qcow2 to iso instead
```

--------------------------------

### Run Bluefin ISO with Just

Source: https://github.com/ublue-os/bluefin-docs/blob/main/docs/local.md

Launches a virtual machine to run a Bluefin OS ISO image using the 'just' tool. It requires the image name and tag.

```bash
just run-iso bluefin stable
```

--------------------------------

### Build Bluefin Images with Just

Source: https://github.com/ublue-os/bluefin-docs/blob/main/docs/local.md

Demonstrates how to build different variants of Bluefin OS images using the 'just' build tool. It specifies the image name, tag, and flavor.

```bash
just build bluefin
just build bluefin-dx gts
just build bluefin-dx beta nvidia
just build bluefin stable nvidia
```

--------------------------------

### Build Bluefin ISO with Just

Source: https://github.com/ublue-os/bluefin-docs/blob/main/docs/local.md

Builds an ISO image of Bluefin OS using the 'just' build tool. It requires specifying the image name and tag.

```bash
just build-iso bluefin stable
```

--------------------------------

### Clone Bluefin Repository

Source: https://github.com/ublue-os/bluefin-docs/blob/main/docs/local.md

Clones the Bluefin OS source code repository from GitHub. This is the initial step before building any components.

```bash
git clone https://github.com/ublue-os/bluefin.git
```

--------------------------------

### System Performance Profiling Tools

Source: https://github.com/ublue-os/bluefin-docs/blob/main/docs/bluefin-dx.md

Bluefin includes Sysprof for system-wide performance profiling, along with Brendan Gregg's recommended CLI tools for detailed analysis.

```shell
bcc
bpftrace
iproute2
nicstat
numactl
sysprof
sysstat
tiptop
trace-cmd
util-linux
```

--------------------------------

### Enable CLI Features and View Stats with atuin

Source: https://github.com/ublue-os/bluefin-docs/blob/main/blog/2024-12-30-ublue-2024-wrapup.md

This snippet demonstrates how to enable specific CLI features (bluefin-cli, bazzite-cli, or aurora-cli) and then use the `atuin wrapped` command to view CLI statistics for the year. It's a user-facing command for personalization and review.

```bash
atuin wrapped
```

--------------------------------

### Quality of Life Improvements and Utilities

Source: https://github.com/ublue-os/bluefin-docs/blob/main/docs/bluefin-dx.md

Includes Cockpit for management, various monospace fonts, Tailscale for VPN, the 'just' task runner, and optional shells like fish and zsh.

```markdown
- [Cockpit](https://cockpit-project.org/)
- [Tailscale](https://universal-blue.discourse.group/t/tailscale-vpn-on-bluefin/290)
- [Just](https://github.com/casey/just)
- `fish`
- `zsh`
```

--------------------------------

### Run System Upgrade and View Changelogs

Source: https://github.com/ublue-os/bluefin-docs/blob/main/docs/installation.md

Commands to perform a system upgrade, view incoming changes from Fedora, and manage BIOS settings. The update process may require a reboot. `ujust bios` is useful for booting into other operating systems like Windows.

```bash
ujust update
ujust changelogs
ujust bios
```

--------------------------------

### Enroll Secure Boot Key

Source: https://github.com/ublue-os/bluefin-docs/blob/main/docs/installation.md

Commands to enroll the Universal Blue Secure Boot key. This provides an additional layer of security. The process involves using `mokutil` to import the key, and a password `universalblue` may be required.

```bash
ujust enroll-secure-boot-key
```

```bash
sudo mokutil --timeout -1
sudo mokutil --import path/to/public_key.der
```

```bash
mokutil --list-enrolled
```

--------------------------------

### Podman and Podman Desktop for Container Management

Source: https://github.com/ublue-os/bluefin-docs/blob/main/docs/bluefin-dx.md

Podman Desktop is included for container management, with all upstream `podman` tools available. It is the default system container runtime.

```markdown
- [Podman Desktop](https://podman-desktop.io/)
- [Podman Desktop documentation](https://podman-desktop.io/docs/intro)
```

--------------------------------

### Build Bluefin ISO from GHCR with Just

Source: https://github.com/ublue-os/bluefin-docs/blob/main/docs/local.md

Builds a Bluefin OS ISO image by pulling the base image from GHCR (GitHub Container Registry) using the 'build-iso-ghcr' task. This is a convenience task for building ISOs when the image is not locally available.

```bash
just build-iso-ghcr bluefin stable
```

--------------------------------

### Display System Information with fastfetch

Source: https://github.com/ublue-os/bluefin-docs/blob/main/docs/command-line.md

Execute the fastfetch command to display detailed hardware and system information, including username, machine name, and kernel version. Each Bluefin image also shows a 'Forged On' date.

```bash
fastfetch
```

--------------------------------

### Build Bluefin Image with Rechunking

Source: https://github.com/ublue-os/bluefin-docs/blob/main/docs/local.md

Builds a Bluefin OS image and rechunks it for storage optimization using the 'build-rechunk' task. This is a convenience task that calls the 'build' task with the rechunk option enabled.

```bash
just build-rechunk <image> <tag> <flavor>
```

--------------------------------

### Validate Image Build Parameters with Just

Source: https://github.com/ublue-os/bluefin-docs/blob/main/docs/local.md

Validates the combination of image, tag, and flavor arguments for building Bluefin OS components. This task ensures that the provided parameters are valid and supported.

```bash
just validate <image> <tag> <flavor>
```

--------------------------------

### Clean System Components

Source: https://github.com/ublue-os/bluefin-docs/blob/main/docs/installation.md

Command to clean up old containers and unused Flatpak runtimes on the system. This helps free up disk space and maintain system efficiency.

```bash
ujust clean-system
```

--------------------------------

### Import WireGuard Configuration

Source: https://github.com/ublue-os/bluefin-docs/blob/main/docs/installation.md

This command is used to import a WireGuard VPN configuration into NetworkManager. It's an optional step for setting up VPN connections via the command line.

```bash
wg-quick
```

--------------------------------

### Basic Git Commands for Contributing

Source: https://github.com/ublue-os/bluefin-docs/blob/main/docs/contributing.md

A sequence of fundamental Git commands used for forking a repository, cloning it locally, creating a new branch, making changes, committing them, and pushing them to a remote fork. This workflow is standard for contributing to open-source projects.

```shell
git clone <repository-url>
git checkout -b <new-branch-name>
# Make your code changes
git add .
git commit -m "<your-commit-message>"
git push origin <new-branch-name>
```

--------------------------------

### Using 'ujust' for System Management and Debugging

Source: https://github.com/ublue-os/bluefin-docs/blob/main/docs/administration.md

Bluefin OS utilizes 'just' as a task runner, aliased as 'ujust'. This provides convenient commands for system updates, debugging, and hardware access. The `--choose` flag lists all available commands and their scripts, while `-n` runs a command in dry-run mode for inspection. Specific commands like `ujust update`, `ujust bios`, `ujust device-info`, and `ujust changelogs` offer streamlined management.

```Shell
ujust --choose
ujust -n update
ujust update
ujust bios
ujust device-info
ujust changelogs
```

--------------------------------

### Enable Developer Mode

Source: https://github.com/ublue-os/bluefin-docs/blob/main/docs/installation.md

This command enables developer mode in Bluefin OS, providing access to additional tools and configurations for development. Follow the on-screen instructions after execution.

```bash
ujust devmode
```

--------------------------------

### Rechunk Bluefin Image with Just

Source: https://github.com/ublue-os/bluefin-docs/blob/main/docs/local.md

Optimizes the storage of a locally built Bluefin OS image by rechunking it using the 'rechunk' task. This involves pruning, creating, and chunking the image.

```bash
just rechunk <image> <tag>
```

--------------------------------

### Test Bluefin Changelogs with Python

Source: https://github.com/ublue-os/bluefin-docs/blob/main/docs/local.md

Tests the changelog generation process for a specified branch using an accompanying Python script. The results are output to specified files.

```bash
just changelogs <branch>
```

--------------------------------

### Alternative for missing gnome-user-share: rclone mount

Source: https://github.com/ublue-os/bluefin-docs/blob/main/blog/2025-09-18-bluefin-lts-and-gdx.md

As a workaround for the missing gnome-user-share functionality in Bluefin LTS, this command demonstrates how to use rclone mount. This is recommended for users who need to mount remote storage.

```bash
rclone mount <remote>:<path> <mountpoint>
```

--------------------------------

### Customizing Tasks with '.Justfile'

Source: https://github.com/ublue-os/bluefin-docs/blob/main/docs/administration.md

Users can define their own tasks and aliases by creating a `.Justfile` in their home directory (`~/.Justfile`) or at the root of their project files. This allows for automation of common tasks and custom workflows, similar to how it's used in projects like Fedora Kinoite.

```Makefile
# Example content for ~/.Justfile or project's Justfile:

# Define a custom task
my-task:
	@echo "Running my custom task..."

# Alias for updating system components
update:
	ujust update

```

--------------------------------

### Sudo Clean Build Artifacts with Just

Source: https://github.com/ublue-os/bluefin-docs/blob/main/docs/local.md

Performs a clean operation with elevated privileges using the 'sudo-clean' task in the Justfile. This ensures all build artifacts, including those requiring root access, are removed.

```bash
just sudo-clean
```

--------------------------------

### Verify ISO Download Integrity with SHA256SUM

Source: https://github.com/ublue-os/bluefin-docs/blob/main/docs/downloads.md

Instructions on how to verify downloaded ISO files using the sha256sum command-line utility. This process ensures the downloaded file has not been corrupted or tampered with by comparing its checksum against a provided official checksum.

```bash
sha256sum bluefin-stable-x86_64.iso
```

```bash
cat bluefin-stable-x86_64.iso-CHECKSUM
```

```bash
# Generate checksum of downloaded file
$ sha256sum bluefin-stable-x86_64.iso
a1b2c3d4e5f6789012345678901234567890abcdef1234567890abcdef123456  bluefin-stable-x86_64.iso

# Check official checksum
$ cat bluefin-stable-x86_64.iso-CHECKSUM
a1b2c3d4e5f6789012345678901234567890abcdef1234567890abcdef123456  bluefin-stable-x86_64.iso

# 🦖 Rawr! Your download is verified
```

--------------------------------

### Manage Local Models with Ramalama (rl)

Source: https://github.com/ublue-os/bluefin-docs/blob/main/docs/ai.md

Ramalama, aliased as 'rl' in Bluefin, is a command-line tool for managing local AI models. It allows pulling models from various registries, running them, and serving them locally with an OpenAI-compatible endpoint. It integrates with container storage for centralized management.

```shell
rl pull llama3.2:latest
rl run llama3.2
rl run deepseek-r1
rl serve deepseek-r1
```

```shell
❯ podman images
REPOSITORY                                 TAG         IMAGE ID      CREATED        SIZE
quay.io/ramalama/rocm                      latest      8875feffdb87  5 days ago     6.92 GB
```

--------------------------------

### Format Code with Prettier (npm)

Source: https://github.com/ublue-os/bluefin-docs/blob/main/README.md

Formats all project files according to Prettier's configuration, ensuring consistent code style across the project.

```bash
npm run prettier
```

--------------------------------

### DevPod for Reproducible Developer Environments

Source: https://github.com/ublue-os/bluefin-docs/blob/main/docs/bluefin-dx.md

DevPod is an open-source tool for creating reproducible developer environments using `devcontainer.json` files. It supports various container runtimes including Docker.

```markdown
- [DevPod Website](https://devpod.sh/)
- [DevPod Documentation](https://devpod.sh/docs/what-is-devpod)
- [DevPod Quickstart VS Code](https://devpod.sh/docs/getting-started/quickstart-vscode)
- [Loft.sh](https://www.loft.sh/)
```

--------------------------------

### Checking System Status with bootc

Source: https://github.com/ublue-os/bluefin-docs/blob/main/docs/contributing.md

This command is used to retrieve the current status of the boot process or system, often helpful when diagnosing issues. It's a diagnostic tool that provides insights into the system's state.

```shell
sudo bootc status
```

--------------------------------

### Enable MangoHud for Steam Games

Source: https://github.com/ublue-os/bluefin-docs/blob/main/docs/gaming.md

Command to enable MangoHud for Steam games by setting an environment variable. This allows MangoHud to overlay performance metrics on games launched through Steam.

```bash
flatpak override --user --env=MANGOHUD=1 com.valvesoftware.Steam
```

--------------------------------

### Enable Local Layering in rpm-ostreed.conf

Source: https://github.com/ublue-os/bluefin-docs/blob/main/docs/administration.md

This configuration setting in `/etc/rpm-ostreed.conf` allows for the addition of individual packages onto the system. Setting `LockLayering` to `false` enables this functionality. Be aware that this may increase update times and requires manual maintenance. Changes require `rpm-ostree reset` and a reboot to take effect.

```INI
LockLayering=false
```

--------------------------------

### Switch Bluefin OS to :gts Tag (Default)

Source: https://github.com/ublue-os/bluefin-docs/blob/main/docs/administration.md

Rebases the system to the default development release ('gts') of Bluefin OS. Includes signature policy enforcement.

```sh
sudo bootc switch ghcr.io/ublue-os/bluefin:gts --enforce-container-sigpolicy
```

--------------------------------

### Switch Bluefin OS to a Specific Date Tag

Source: https://github.com/ublue-os/bluefin-docs/blob/main/docs/administration.md

Rebases the system to an image tagged with a specific date, enabling pinning to a particular build date and version.

```sh
sudo bootc switch ghcr.io/ublue-os/bluefin:stable-20241027 --enforce-container-sigpolicy
```

--------------------------------

### Switch Bluefin OS to :stable Tag

Source: https://github.com/ublue-os/bluefin-docs/blob/main/docs/administration.md

Rebases the system to the latest stable release of Bluefin OS. The `--enforce-container-sigpolicy` flag ensures signature verification of the image.

```sh
sudo bootc switch ghcr.io/ublue-os/bluefin:stable --enforce-container-sigpolicy
```

--------------------------------

### Enable MangoHud in Shell Profile

Source: https://github.com/ublue-os/bluefin-docs/blob/main/docs/gaming.md

Alternative method to enable MangoHud by setting an environment variable in the shell profile. This method is specific to Vulkan applications.

```bash
MANGOHUD=1
```

--------------------------------

### Toggle Tailscale VPN

Source: https://github.com/ublue-os/bluefin-docs/blob/main/docs/introduction.md

Command to disable the Tailscale VPN service if it is not needed. This is useful for users who do not require VPN connectivity.

```bash
ujust toggle-tailscale
```

--------------------------------

### Enable TPM Unlock for LUKS Encryption

Source: https://github.com/ublue-os/bluefin-docs/blob/main/docs/framework.md

This command enables Trusted Platform Module (TPM) unlock for LUKS disk encryption, allowing users to unlock their encrypted drives using a fingerprint reader.

```bash
ujust setup-luks-tpm-unlock
```

--------------------------------

### Check Bluefin Changelogs

Source: https://github.com/ublue-os/bluefin-docs/blob/main/blog/2025-05-14-bluefin-f42.md

This command allows users to view the changelogs for Bluefin OS, providing insights into package updates and release notes. It's a convenient way to stay informed about the latest changes.

```bash
ujust changelogs
```

--------------------------------

### Visual Studio Code with Docker Integration

Source: https://github.com/ublue-os/bluefin-docs/blob/main/docs/bluefin-dx.md

Visual Studio Code is included with the devcontainers extension for a seamless containerized development experience. Docker Engine is the default container runtime, supporting Docker Compose for development.

```markdown
- [Visual Studio Code](https://code.visualstudio.com/)
- [Dev Containers Documentation](https://code.visualstudio.com/docs/devcontainers/containers)
- [Dev Containers Specification](https://containers.dev/)
- [Beginner's Series to: Dev Containers](https://www.youtube.com/watch?v=b1RavPr_878)
- [Docker Engine](https://docs.docker.com/engine/)
- [docker compose](https://danielquinn.org/blog/developing-with-docker/)
```

--------------------------------

### Verify Bluefin OS Image Signature with Cosign

Source: https://github.com/ublue-os/bluefin-docs/blob/main/docs/administration.md

This command verifies the signature of the Bluefin OS image using cosign. It requires the cosign binary and the public key (`cosign.pub`) to be available. The command checks the integrity and authenticity of the image hosted on ghcr.io.

```sh
cosign verify --key cosign.pub ghcr.io/ublue-os/bluefin
```

--------------------------------

### Switch Bluefin OS to a Specific Fedora Version Tag

Source: https://github.com/ublue-os/bluefin-docs/blob/main/docs/administration.md

Rebases the system to a specific Fedora release version tag, such as '40'. This allows manual control over the upgrade cycle.

```sh
sudo bootc switch ghcr.io/ublue-os/bluefin:40 --enforce-container-sigpolicy
```

--------------------------------

### Check Idle Power Draw

Source: https://github.com/ublue-os/bluefin-docs/blob/main/docs/framework.md

This command utilizes the 'powerstat' utility to check the idle power draw of the system, useful for monitoring energy consumption.

```bash
ujust check-idle-power-draw
```

--------------------------------

### Inspect Image Information with Skopeo

Source: https://github.com/ublue-os/bluefin-docs/blob/main/docs/administration.md

Queries an image registry to retrieve metadata about an image, including available tags and version details. Useful for exploring available image variants.

```sh
skopeo inspect docker://ghcr.io/ublue-os/bluefin
```

--------------------------------

### Switch NVIDIA Bluefin OS to :stable Tag

Source: https://github.com/ublue-os/bluefin-docs/blob/main/docs/administration.md

Rebases the system to the latest stable release of the NVIDIA variant of Bluefin OS. The `-nvidia` suffix is crucial for NVIDIA hardware.

```sh
sudo bootc switch ghcr.io/ublue-os/bluefin-nvidia:stable --enforce-container-sigpolicy
```

--------------------------------

### Reset Local Packages with rpm-ostree

Source: https://github.com/ublue-os/bluefin-docs/blob/main/docs/administration.md

Resets any locally layered packages before changing a stream. This is a prerequisite for rebasing to a new image tag.

```sh
rpm-ostree reset
```

--------------------------------

### Change Default Terminal Shell in Ptyxis

Source: https://github.com/ublue-os/bluefin-docs/blob/main/docs/command-line.md

Instructions for changing the default terminal shell within the Ptyxis terminal emulator. Users can select custom commands to use alternative shells like fish or zsh.

```bash
SHELL=fish ujust bluefin-cli
SHELL=zsh ujust bluefin-cli
# Or do it all at once from bash with
ujust bluefin-cli && SHELL=fish ujust bluefin-cli && SHELL=zsh ujust bluefin-cli
```

--------------------------------

### Toggle User Message of the Day

Source: https://github.com/ublue-os/bluefin-docs/blob/main/docs/command-line.md

Command to toggle the user's message of the day on or off in Bluefin OS. This feature displays system information in new terminal sessions.

```bash
ujust toggle-user-motd
```

--------------------------------

### Disable Homebrew Analytics

Source: https://github.com/ublue-os/bluefin-docs/blob/main/docs/analytics.mdx

Command to disable analytics tracking in Homebrew. This ensures no telemetry data is sent to Homebrew servers.

```bash
brew analytics off
```

--------------------------------

### Disable Starship Prompt in Bash

Source: https://github.com/ublue-os/bluefin-docs/blob/main/docs/FAQ.md

This snippet shows how to disable the Starship prompt in Bash by commenting out or removing the initialization line from the /etc/bashrc file. This reverts the prompt to the default Linux prompt.

```bash
eval "$(starship init bash)"
```

=== COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.