### Configure Quadlet Service to Start on Boot

Source: https://github.com/ublue-os/aurora-docs/blob/main/docs/guides/quadlet.md

This example shows how to add an '[Install]' section to a Quadlet file to ensure the container service starts automatically on system boot. It uses 'default.target' to define the startup behavior.

```containerfile
[Container]
ContainerName=nginx
Image=docker.io/nginxinc/nginx-unprivileged
PublishPort=8080:8080

[Install]
WantedBy=default.target
```

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

### Install Kubernetes Tools via ujust

Source: https://github.com/ublue-os/aurora-docs/blob/main/docs/dx/local-kubernetes.md

Uses the ujust CLI utility to trigger the installation of various Kubernetes development tools, including kind, helm, and kubectl. This command simplifies the setup process by automating the installation of essential container and cluster management packages.

```bash
ujust bbrew
```

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

### Install JetBrains Toolbox

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

Fetches and installs the JetBrains Toolbox application, which manages the installation, removal, and upgrades of JetBrains IDEs. This process is contained within your home directory and is independent of the operating system image. Flatpak installations of JetBrains products are not recommended.

```bash
ujust jetbrains-toolbox
```

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

### Flatpak Software Installation

Source: https://context7.com/ublue-os/aurora-docs/llms.txt

Guide to installing graphical applications using Flatpak on Aurora OS, with Flathub as the default repository. Includes commands for installation, searching, listing, updating, and running applications, as well as managing permissions with Flatseal and advanced management with Warehouse.

```bash
# Install a Flatpak application
flatpak install flathub com.valvesoftware.Steam

# Search for applications
flatpak search firefox

# List installed Flatpaks
flatpak list

# Update all Flatpaks
flatpak update

# Run a Flatpak application
flatpak run com.valvesoftware.Steam

# Manage Flatpak permissions with Flatseal (pre-installed)
flatpak run com.github.tchx84.Flatseal

# Manage Flatpaks with Warehouse (downgrade, backup, remotes)
flatpak run io.github.flattool.Warehouse
```

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

### Install Aurora OS

Source: https://context7.com/ublue-os/aurora-docs/llms.txt

Instructions for downloading, flashing, and installing Aurora OS. It includes a note about the secure boot password and how to verify the system after installation.

```bash
# Download ISO from the official website
# https://getaurora.dev or https://fosstorrents.com/distributions/aurora/

# Flash with Fedora Media Writer, Rufus, or Etcher
# Boot from the USB and follow the installer

# Secure boot password (if prompted for MOK enrollment)
# Password: universalblue

# After installation, verify your system
rpm-ostree status
```

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

### Create and Start Nginx Container with Quadlet

Source: https://github.com/ublue-os/aurora-docs/blob/main/docs/guides/quadlet.md

This snippet demonstrates how to create a Quadlet container definition file for Nginx and then start the container using systemd user services. It also includes opening the service in a web browser.

```containerfile
[Container]
ContainerName=nginx
Image=docker.io/nginxinc/nginx-unprivileged
PublishPort=8080:8080
```

```shell
systemctl --user daemon-reload
systemctl --user start nginx
xdg-open localhost:8080
```

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

### Aurora CLI Tools Bundle Installation

Source: https://context7.com/ublue-os/aurora-docs/llms.txt

Details on installing Aurora's curated collection of modern CLI tools. Lists the included tools such as atuin, bat, eza, fd, rg, starship, zoxide, chezmoi, direnv, gh, glab, tealdeer, television, and yq, with examples of their usage.

```bash
# Install Aurora CLI tools bundle
ujust aurora-cli

# After installation, available tools include:
# atuin - magical shell history search
# bat - cat clone with syntax highlighting
# eza - modern ls replacement
# fd - fast alternative to find
# rg (ripgrep) - fast recursive grep
# starship - customizable prompt
# zoxide - smarter cd command
# chezmoi - dotfiles manager
# direnv - directory-based env vars
# gh - GitHub CLI
# glab - GitLab CLI
# tealdeer - fast tldr pages
# television - fuzzy finder TUI
# yq - YAML/JSON processor

# Example usage of installed tools
eza -la --git                    # List files with git status
bat README.md                    # View file with syntax highlighting
fd "\.md$"                      # Find all markdown files
rg "TODO" --type rust           # Search for TODO in Rust files
z projects                       # Jump to frequently used directory
```

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

### Install Neovim and Devcontainer Tools

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

Installs Neovim and the devcontainer package using Homebrew. This is a prerequisite for setting up Neovim within a devcontainer environment, following the provided documentation links for detailed configuration.

```bash
brew install neovim devcontainer
```

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

### Homebrew Command-Line Tool Installation

Source: https://context7.com/ublue-os/aurora-docs/llms.txt

Instructions for installing command-line tools and development utilities using Homebrew on Aurora OS. Covers installing single or multiple packages, searching, updating, listing, getting info, uninstalling, and installing specific fonts.

```bash
# Install a CLI tool
brew install nodejs

# Install a specific version
brew install openjdk@21

# Install multiple tools
brew install go rust python

# Search for packages
brew search kubernetes

# Update Homebrew and upgrade packages
brew update && brew upgrade

# List installed packages
brew list

# Get package info
brew info kubectl

# Uninstall a package
brew uninstall nodejs

# Install Microsoft fonts (requires license)
brew tap colindean/fonts-nonfree && brew install --cask font-microsoft-office font-arial font-times-new-roman
```

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

### Install development tools via Homebrew

Source: https://github.com/ublue-os/aurora-docs/blob/main/docs/dx/different-workflows.md

Demonstrates how to install programming language toolchains and runtimes using the Homebrew package manager. This approach allows developers to manage dependencies directly within their home directory.

```bash
brew install nodejs # or go, rust, openjdk
brew install openjdk@21
```

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

### Kubernetes and Cloud-Native Tooling

Source: https://context7.com/ublue-os/aurora-docs/llms.txt

Instructions for installing CNCF tools, managing local Kubernetes clusters with kind, and utilizing Helm and security scanning tools.

```bash
ujust bbrew
ujust cncf
kind create cluster --name dev-cluster
kubectl cluster-info
kubectl get nodes
kubectl create deployment nginx --image=nginx
kubectl expose deployment nginx --port=80 --type=NodePort
kubectl get services
k9s
kubectx
kubectx dev-cluster
helm repo add bitnami https://charts.bitnami.com/bitnami
helm install my-redis bitnami/redis
helm list
grype nginx:latest
syft nginx:latest
kind delete cluster --name dev-cluster
```

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

### Sunshine Service Management

Source: https://github.com/ublue-os/aurora-docs/blob/main/docs/guides/sunshine.md

Utility commands to set up, start, stop, and enable the Sunshine service using systemd and Aurora convenience scripts.

```bash
# Complete setup including service enablement
ujust setup-sunshine

# Check Sunshine status
systemctl --user status sunshine

# Start Sunshine
systemctl --user start sunshine

# Stop Sunshine
systemctl --user stop sunshine

# Enable automatic startup
systemctl --user enable sunshine

# Disable automatic startup
systemctl --user disable sunshine
```

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

### Add Homebrew to Custom Images using OCI Container

Source: https://github.com/ublue-os/aurora-docs/blob/main/blog/2025-12-16-Backend changes-flatpak-support-in-brew.md

This Dockerfile snippet demonstrates how to easily integrate Homebrew into custom bootc images. It leverages a pre-packaged OCI container from the Project Bluefin repository, which includes all necessary components and services for Homebrew setup and maintenance. This simplifies the process by eliminating manual configuration.

```dockerfile
COPY --from=ghcr.io/projectbluefin/brew:latest /system_files /

```

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

### Access CNCF Tool Suite via ujust

Source: https://github.com/ublue-os/aurora-docs/blob/main/docs/dx/local-kubernetes.md

Provides access to an extensive collection of 89 CNCF projects, including graduated, incubating, and sandbox tools. This command allows users to browse and install specialized cloud-native software like Argo, Cilium, and Istio.

```bash
ujust cncf
```

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

### Configure Gaming Environment

Source: https://context7.com/ublue-os/aurora-docs/llms.txt

Installs essential gaming software and Vulkan layers via Flatpak. Includes commands for Steam, Lutris, and performance monitoring tools.

```bash
flatpak install flathub com.valvesoftware.Steam
flatpak install flathub net.lutris.Lutris
flatpak install flathub org.freedesktop.Platform.VulkanLayer.MangoHud
flatpak run com.valvesoftware.Steam
```

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

### Bold Brew Curated Tool Bundles

Source: https://context7.com/ublue-os/aurora-docs/llms.txt

Information on launching the Bold Brew bundle selector via 'ujust bbrew' to install curated collections of tools. It notes that available bundles are listed after launching the selector.

```bash
# Launch Bold Brew bundle selector
ujust bbrew

# Available bundles include:

```

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

### Install Microsoft Fonts with Homebrew

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

Installs a collection of Microsoft fonts using Homebrew, including common fonts like Arial, Times New Roman, and Courier New. This ensures compatibility with documents that rely on these specific fonts. Ensure you have the necessary permissions or licenses as per Microsoft's guidelines.

```bash
brew tap colindean/fonts-nonfree && brew install --cask font-microsoft-office font-microsoft-aptos font-arial font-arial-black font-courier-new font-times-new-roman font-georgia
```

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

### Enable Aurora Developer Experience (Aurora-DX)

Source: https://context7.com/ublue-os/aurora-docs/llms.txt

Setup commands to enable developer mode, configure user groups for virtualization and container runtimes, and manage containerized workflows.

```bash
ujust devmode
ujust dx-group
docker run hello-world
podman run hello-world
ujust jetbrains-toolbox
docker ps
podman ps
docker compose up -d
docker compose logs -f
docker compose down
flatpak run io.podman_desktop.PodmanDesktop
```

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

### Configure Devcontainers for Isolated Environments

Source: https://context7.com/ublue-os/aurora-docs/llms.txt

Example JSON configuration for a Node.js development environment and CLI commands to interact with devcontainers in VS Code.

```json
{
  "name": "Node.js Development",
  "image": "mcr.microsoft.com/devcontainers/javascript-node:18",
  "features": {
    "ghcr.io/devcontainers/features/docker-in-docker:2": {}
  },
  "postCreateCommand": "npm install",
  "customizations": {
    "vscode": {
      "extensions": [
        "dbaeumer.vscode-eslint",
        "esbenp.prettier-vscode"
      ]
    }
  },
  "forwardPorts": [3000],
  "remoteUser": "node"
}
```

```bash
code /path/to/project
brew install devcontainer
devcontainer up --workspace-folder .
devcontainer exec --workspace-folder . npm test
```

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

### Build Aurora Images Locally

Source: https://context7.com/ublue-os/aurora-docs/llms.txt

Uses the just build system to compile custom Aurora OS images. Requires prerequisites like git, podman, and build tools.

```bash
git clone https://github.com/ublue-os/aurora
cd aurora
just build aurora
just build aurora-dx beta nvidia-open
```

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

### Network and Hardware Diagnostics

Source: https://github.com/ublue-os/aurora-docs/blob/main/docs/guides/sunshine.md

Commands to identify the host machine's IP address and verify NVIDIA GPU driver and encoder status.

```bash
# Find your local IP address
ip addr show | grep 'inet ' | grep -v '127.0.0.1'
# Or use the simpler command:
hostname -I
```

```bash
# Ensure NVIDIA drivers are properly installed
nvidia-smi
# Check for NVENC support
nvidia-ml-py3
```

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

### Clone Aurora Repository

Source: https://github.com/ublue-os/aurora-docs/blob/main/docs/guides/building.md

Initializes the local development environment by cloning the main Aurora repository and navigating to the directory.

```shell
git clone https://github.com/ublue-os/aurora
cd aurora
```

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

### Manage Local AI Models with Ramalama

Source: https://context7.com/ublue-os/aurora-docs/llms.txt

Commands to install, pull, run, and serve local AI models. It supports various providers including Ollama and Hugging Face, and integrates with container runtimes.

```bash
brew install ramalama
rl pull llama3.2:latest
rl run llama3.2
rl serve deepseek-r1
rl list
rl pull huggingface://mistralai/Mistral-7B-v0.1
podman images
```

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

### Sunshine Logging and Troubleshooting

Source: https://github.com/ublue-os/aurora-docs/blob/main/docs/guides/sunshine.md

Commands to monitor real-time logs, view historical logs, and export logs for troubleshooting purposes.

```bash
# View real-time logs
journalctl --user -f -u sunshine

# View recent logs
journalctl --user -u sunshine --since "1 hour ago"

# Collect detailed logs for troubleshooting
journalctl --user -u sunshine > sunshine_logs.txt
```

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

### Run Containerized Services with Podman Quadlet

Source: https://context7.com/ublue-os/aurora-docs/llms.txt

Automate container deployment as systemd services using Quadlet files. This ensures services persist and restart automatically.

```bash
mkdir -p ~/.config/containers/systemd/
cat > ~/.config/containers/systemd/nginx.container << 'EOF'
[Container]
ContainerName=nginx
Image=docker.io/nginxinc/nginx-unprivileged
PublishPort=8080:8080

[Install]
WantedBy=default.target
EOF
systemctl --user daemon-reload
systemctl --user start nginx
systemctl --user status nginx
journalctl --user -u nginx -f
systemctl --user stop nginx
loginctl enable-linger $USER
```

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

### Custom Application Configuration

Source: https://github.com/ublue-os/aurora-docs/blob/main/docs/guides/sunshine.md

JSON schema for defining custom applications in Sunshine's apps.json file to allow streaming of non-Steam games.

```json
{
  "name": "Custom Game",
  "cmd": "/path/to/game/executable",
  "working-dir": "/path/to/game/",
  "image-path": "/path/to/icon.png"
}
```

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

### Convert Docker Compose to Quadlet

Source: https://context7.com/ublue-os/aurora-docs/llms.txt

Uses the podlet tool to migrate existing docker-compose configurations into systemd-compatible Quadlet files.

```bash
brew install podlet
podlet compose docker-compose.yml
```

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

### Manage Quadlet Service Status and Stopping

Source: https://github.com/ublue-os/aurora-docs/blob/main/docs/guides/quadlet.md

These commands illustrate how to check the status of a Quadlet-managed service and how to stop it using the systemd user service manager.

```shell
systemctl --user status nginx
```

```shell
systemctl --user stop nginx
```

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

### Rebase to Local Image

Source: https://github.com/ublue-os/aurora-docs/blob/main/docs/guides/building.md

Commands to move a locally built image to the root container storage and switch the system bootc target to the new image.

```shell
podman image scp localhost/aurora:latest root@localhost
sudo bootc switch --transport containers-storage localhost/aurora:latest
systemctl reboot
```

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

### Manage Linux Containers with Distrobox

Source: https://context7.com/ublue-os/aurora-docs/llms.txt

Commands to create, manage, and export applications from various Linux distribution containers. This allows users to leverage different package managers within an isolated environment.

```bash
distrobox create --name fedora-box --image fedora:latest
distrobox create --name ubuntu-box --image ubuntu:22.04
distrobox create --name arch-box --image archlinux:latest
distrobox enter fedora-box
sudo dnf install vim gcc make
sudo apt install build-essential
distrobox-export --app firefox
distrobox-export --bin /usr/bin/nvim --export-path ~/.local/bin
distrobox list
distrobox stop fedora-box
distrobox rm fedora-box
flatpak run com.ranfdev.DistroShelf
```