dx-setup

name	dx-setup
description	Set up and configure Bluefin DX for cloud-native development — tools, containers, IDE integration.
domain	development

Bluefin DX Setup

Bluefin DX (Developer Experience) is a variant of Bluefin with cloud-native developer tools pre-installed: kubectl, helm, kind, go, node, Podman, and more.

Load with: point your agent at this file.

When to Use

• First-time DX setup on a new machine
• Checking which developer tools are available
• Configuring shell, IDE, or container environment
• Understanding the DX tool stack

When NOT to Use

• Non-DX Bluefin — switch to the DX image first: check bootc status
• Bluefin Aurora DX — some tooling differs (check aurora-specific docs)

Check If You Have DX

# Check your current image
bootc status --json | jq -r '.status.booted.image.image.image'
# Should contain "bluefin-dx" in the image name (not the tag)

# Or check for dx-specific tools
which kubectl && echo "DX tools present"

Switching to DX

If you're on base Bluefin and want DX, rebase:

# Switch to Bluefin DX (replace XX with your Fedora version)
ujust rebase-helper

Included Tools

Tool	Purpose
kubectl	Kubernetes CLI
helm	Kubernetes package manager
kind	Local Kubernetes clusters
podman	OCI container engine
buildah	Container image builder
skopeo	Container registry tool
go	Go language toolchain
node	Node.js (via nvm or system)
devcontainer	VS Code devcontainer CLI

Shell Setup

DX uses fish or bash. Check echo $SHELL.

# Useful aliases (add to ~/.bashrc or ~/.config/fish/config.fish)
alias k=kubectl
alias kns='kubectl config set-context --current --namespace'

VS Code / Cursor

VS Code is available as a Flatpak. Install:

flatpak install flathub com.visualstudio.code

For devcontainer support, install the Dev Containers extension inside VS Code.

AI Development Tools

Bluefin DX integrates well with AI coding tools:

# GitHub Copilot CLI
brew install gh
gh extension install github/gh-copilot

# OpenCode
# Check the Bluefin testhub for available AI tools

ujust Recipes

ujust          # show all available recipes
ujust dx-group # add docker/incus/libvirt/serial group permissions for the current user
               # required for Docker, Podman socket, libvirt, and serial device access
               # (reboot required after running)

Container Management

Use Distroshelf (io.github.ranfdev.DistroShelf) for a GUI view of Distrobox containers. Install: flatpak install flathub io.github.ranfdev.DistroShelf