Quick Start Guide#

TL;DR for experienced users. Get up and running fast.

Install#

# From existing Fedora Atomic/Silverblue
sudo bootc switch ghcr.io/immutablue/immutablue:latest

# Reboot
sudo reboot

First Boot#

  1. Complete the setup wizard
  2. Reboot when prompted

Install Software#

# GUI apps → Flatpak
flatpak install flathub org.mozilla.firefox

# CLI tools → Homebrew
brew install ripgrep fzf bat

# Dev environments → Distrobox
distrobox create -n dev -i fedora:latest
distrobox enter dev

Update Everything#

immutablue update

Check System Health#

immutablue doctor

Common Tasks#

TaskCommand
Update systemimmutablue update
Health checkimmutablue doctor
Reboot to BIOSimmutablue bios
System infoimmutablue sysinfo
Enable VMsimmutablue enable_libvirt
Clean systemimmutablue clean_system

Configure#

# Create user config
mkdir -p ~/.config/immutablue
cat > ~/.config/immutablue/settings.yaml << 'EOF'
immutablue:
  profile:
    enable_starship: true
EOF

Key Directories#

PathPurpose
~/.config/immutablue/User settings
/etc/immutablue/System settings
/usr/immutablue/Default settings
/etc/immutablue/scripts/Custom automation scripts

Useful Commands#

# Query settings
immutablue-settings .immutablue.profile.enable_starship

# List timers
systemctl list-timers | grep immutablue

# View update logs
journalctl -u immutablue-weekly.service

# Test in VM
immutablue-lima-gen && limactl start immutablue

Need Help?#