Command Reference¶

Bazzite AI OS provides ujust commands for system management and development workflows.

Bazzite AI OS Only

These commands require Bazzite AI OS. For other platforms, see Docker/Podman or Kubernetes.

Quick Start¶

# Show all available commands
ujust --list

# Get help for a specific command
ujust --help <command>

Pod Commands¶

Running Pods¶

Use Apptainer or Podman directly to run pods:

# With Apptainer (recommended for HPC/scientific computing)
apptainer pull docker://ghcr.io/atrawog/bazzite-ai-pod-nvidia-python:stable
apptainer shell --nv bazzite-ai-pod-nvidia-python_stable.sif

# With Podman
podman pull ghcr.io/atrawog/bazzite-ai-pod-nvidia-python:stable
podman run --rm -it --device nvidia.com/gpu=all \
  ghcr.io/atrawog/bazzite-ai-pod-nvidia-python:stable /bin/zsh

Available pod variants: base, nvidia, nvidia-python, jupyter, devops, playwright, githubrunner

Building Pods¶

Command	Description
`ujust pod build <variant>`	Build specific pod variant
`ujust pod build all`	Build all pod variants
`ujust rebuild-pod [tag] [cache_mode]`	Rebuild with cache control

GPU Commands¶

Command	Description
`ujust setup-gpu-pods`	Configure NVIDIA container toolkit (one-time)
`ujust test-cuda-pod [tag]`	Test CUDA access in pod

System Management¶

Services¶

Command	Description
`ujust toggle-sshd [status]`	Enable/disable/status SSH server
`ujust toggle-docker [status]`	Enable/disable/status Docker
`ujust toggle-libvirtd [status]`	Enable/disable/status libvirt

Updates¶

# Check for OS updates
rpm-ostree upgrade --check

# Apply updates
rpm-ostree upgrade

# Rollback if needed
rpm-ostree rollback

Development Commands¶

Testing¶

Command	Description
`ujust test overlay enable`	Enable overlay testing mode
`ujust test overlay disable`	Disable overlay testing mode
`ujust test overlay status`	Check overlay status

Documentation¶

Command	Description
`just docs-build`	Build documentation site
`just docs-serve`	Serve docs at localhost:8000

Building¶

Command	Description
`just build`	Build OS image
`just build-iso`	Build bootable ISO

Kubernetes Tools¶

Kubernetes tools are pre-installed (kubectl, Helm). Local clusters can be installed on-demand:

Command	Description
`ujust install-kind`	Install kind (Kubernetes in Docker)
`ujust install-minikube`	Install minikube

After Installation¶

# kind
kind create cluster
kubectl cluster-info

# minikube
minikube start
minikube dashboard

Virtualization¶

Command	Description
`ujust toggle-libvirtd status`	Check virtualization status
`ujust toggle-libvirtd enable`	Enable virtualization

Virtual Machine GUI¶

# Open virt-manager
virt-manager

WinBoat (Windows)¶

Command	Description
`winboat`	Launch Windows container environment

Environment Setup¶

First-Time Setup¶

# 1. Show available commands
ujust --list

# 2. Setup GPU pods (NVIDIA users)
ujust setup-gpu-pods

# 3. Pull and run a pod with Apptainer
apptainer pull docker://ghcr.io/atrawog/bazzite-ai-pod-nvidia-python:stable
apptainer shell --nv bazzite-ai-pod-nvidia-python_stable.sif

Development Environment¶

# Install development hooks (contributors)
ujust install-dev-environment

# Verify hooks
ujust verify-hooks

Getting Help¶

Command Help¶

# List all commands with descriptions
ujust --list

# Search commands
ujust --list | grep pod
ujust --list | grep gpu

Reporting Issues¶

If a command doesn't work as expected:

Check the command exists: ujust --list | grep <command>
Run with verbose output if available
Check logs: journalctl --user -n 50
Report on GitHub Issues