Immutablue Documentation#

Welcome to Immutablue, an easy, extendable version of Fedora Silverblue with sane defaults built for the future with cloud-native practices.

Quick Links#

🚀 Getting Started#

• Installation Guide
• First Boot Experience
• Quick Start (TL;DR)

📖 User Guide#

• Package Management
• Updating Your System
• System Health (Doctor)
• Settings Reference

🔧 CLI Reference#

• immutablue
• immutablue-update
• immutablue-doctor
• All Commands →

⚙️ System Components#

• Scheduled Scripts
• Systemd Services
• Header Library
• Profile Configuration

🎨 Variants#

• NVIDIA (Cyan)
• Apple Silicon (Asahi)
• Kuberblue (Kubernetes)
• TrueBlue (ZFS)
• All Variants →

🏗️ Building & Customizing#

• Architecture
• Customization Guide
• Build Reference
• Testing

Key Features#

• Immutable base system with transactional updates
• Multiple desktop environments including GNOME (Silverblue), KDE (Kinoite), and more
• Specialized variants for NVIDIA GPUs, Apple Silicon, Kubernetes, and ZFS
• Layered package management using Flatpak, Distrobox, Homebrew, and rpm-ostree
• Automated setup and maintenance with systemd services and timers
• Highly customizable via configuration files and build system

Getting Help#

• GitLab Repository
• Create an Issue
• Run immutablue doctor for system diagnostics

Immutablue is a community project. Contributions, suggestions, and feedback are always welcome!