https://docs.shani.dev/ Comprehensive technical documentation for Shanios — the immutable Linux OS. en-IN Thu, 06 Aug 2026 07:15:29 GMT https://docs.shani.dev/doc/arch/boot/ https://docs.shani.dev/doc/arch/boot/ Boot Process Shanios uses a fully measured, signed boot chain built on systemd-boot, dracut-generated Unified Kernel Images (UKIs), and optionally TPM2 + … Wed, 13 May 2026 00:00:00 GMT Architecture Shrinivas Kumbhar https://docs.shani.dev/doc/arch/btrfs/ https://docs.shani.dev/doc/arch/btrfs/ Btrfs Deep Dive Shanios leverages advanced Btrfs features for immutability, efficiency, and data integrity. Copy-on-Write (CoW) Btrfs CoW minimises stor… Wed, 13 May 2026 00:00:00 GMT Architecture Shrinivas Kumbhar https://docs.shani.dev/doc/arch/dracut-module/ https://docs.shani.dev/doc/arch/dracut-module/ Dracut Initramfs Module Shanios ships a custom dracut module () that adds three hooks to the initramfs. These hooks implement the two features that requir… Wed, 13 May 2026 00:00:00 GMT Architecture Shrinivas Kumbhar https://docs.shani.dev/doc/arch/filesystem/ https://docs.shani.dev/doc/arch/filesystem/ Filesystem Structure Shanios uses Btrfs with a sophisticated subvolume layout housed in a single Btrfs partition (plus a 1 GB FAT32 ESP). The design separ… Wed, 13 May 2026 00:00:00 GMT Architecture Shrinivas Kumbhar https://docs.shani.dev/doc/arch/overlay/ https://docs.shani.dev/doc/arch/overlay/ Overlay Filesystem Shanios uses Linux OverlayFS to present a fully writable on top of a read-only root filesystem. This is what makes the immutable OS fe… Wed, 13 May 2026 00:00:00 GMT Architecture Shrinivas Kumbhar https://docs.shani.dev/doc/faq/ https://docs.shani.dev/doc/faq/ Frequently Asked Questions Answers to the most common questions about Shanios — software installation, updates, hardware, security, and the immutable arch… Wed, 13 May 2026 00:00:00 GMT FAQ Shrinivas Kumbhar https://docs.shani.dev/doc/security/gen-efi/ https://docs.shani.dev/doc/security/gen-efi/ gen-efi Reference is the Shanios UKI (Unified Kernel Image) builder and Secure Boot key manager. It wraps and / to produce signed EFI binaries placed in… Wed, 13 May 2026 00:00:00 GMT Security Shrinivas Kumbhar https://docs.shani.dev/doc/system/backup/ https://docs.shani.dev/doc/system/backup/ Backup & Recovery Shanios protects the OS layer via atomic updates and Btrfs slot snapshots. User data and container state must be backed up independently… Wed, 13 May 2026 00:00:00 GMT System Shrinivas Kumbhar https://docs.shani.dev/doc/troubleshooting/ https://docs.shani.dev/doc/troubleshooting/ Troubleshooting Guide The most important thing to know about troubleshooting Shanios is that the worst case is almost always "rollback and reboot." The ar… Wed, 13 May 2026 00:00:00 GMT System Management Shrinivas Kumbhar https://docs.shani.dev/doc/updates/shani-health/ https://docs.shani.dev/doc/updates/shani-health/ shani-health Reference is the system health and diagnostics CLI for Shanios. It provides a comprehensive single-command view of your system's state: boot… Wed, 13 May 2026 00:00:00 GMT Updates & Config Shrinivas Kumbhar https://docs.shani.dev/doc/updates/shani-reset/ https://docs.shani.dev/doc/updates/shani-reset/ Factory Reset wipes all persistent system state stored in and reboots the machine. On the next boot, recreates the structure, the overlay starts fres… Wed, 13 May 2026 00:00:00 GMT Updates & Config Shrinivas Kumbhar https://docs.shani.dev/doc/updates/system/ https://docs.shani.dev/doc/updates/system/ System Updates Shanios updates are atomic — the running system is never modified. Updates are written to the inactive slot, verified, and activated on the… Wed, 13 May 2026 00:00:00 GMT Updates & Config Shrinivas Kumbhar https://docs.shani.dev/doc/updates/user-setup/ https://docs.shani.dev/doc/updates/user-setup/ User Provisioning automatically provisions every regular user (UID 1000–59999) with the correct groups, default shell, Flatpak remotes, Nix channels, and… Wed, 13 May 2026 00:00:00 GMT Updates & Config Shrinivas Kumbhar https://docs.shani.dev/doc/security/luks/ https://docs.shani.dev/doc/security/luks/ LUKS Management Full-disk encryption with LUKS2 must be enabled during the Shanios installer — it is a single checkbox on the disk setup screen. There is … Sat, 09 May 2026 00:00:00 GMT Security Shrinivas Kumbhar https://docs.shani.dev/doc/software/bottles/ https://docs.shani.dev/doc/software/bottles/ Bottles (Windows Compatibility) Bottles is the recommended tool for running non-gaming Windows software on Shanios. It manages Wine environments ("bottles… Fri, 08 May 2026 00:00:00 GMT Software & Apps Shrinivas Kumbhar https://docs.shani.dev/doc/software/apptainer/ https://docs.shani.dev/doc/software/apptainer/ Apptainer (HPC Containers) Apptainer (formerly Singularity) is the container runtime built for HPC. It packages your entire software environment into a si… Thu, 07 May 2026 00:00:00 GMT Software & Apps Shrinivas Kumbhar https://docs.shani.dev/doc/software/containers/ https://docs.shani.dev/doc/software/containers/ Containers on Shanios Shanios is a first-class container platform. The following runtimes are pre-installed and ready to use: | Runtime | Best for | Wiki… Thu, 07 May 2026 00:00:00 GMT Software & Apps Shrinivas Kumbhar https://docs.shani.dev/doc/software/lxc-lxd/ https://docs.shani.dev/doc/software/lxc-lxd/ LXC and LXD LXC and LXD provide full Linux system containers — a complete operating system (init system, services, network stack) inside an isolated envir… Thu, 07 May 2026 00:00:00 GMT Software & Apps Shrinivas Kumbhar https://docs.shani.dev/doc/software/systemd-nspawn/ https://docs.shani.dev/doc/software/systemd-nspawn/ systemd-nspawn is a lightweight container mechanism built directly into systemd. It runs a full Linux distribution — complete with an init system and its… Thu, 07 May 2026 00:00:00 GMT Software & Apps Shrinivas Kumbhar https://docs.shani.dev/doc/updates/config/ https://docs.shani.dev/doc/updates/config/ System Config All system configuration in Shanios follows standard Linux conventions — edit files in , manage services with . Your changes are captured by… Wed, 06 May 2026 00:00:00 GMT Updates & Config Shrinivas Kumbhar https://docs.shani.dev/doc/security/secure-boot/ https://docs.shani.dev/doc/security/secure-boot/ Secure Boot Shanios ships with its own MOK (Machine Owner Key) and signs all UKI images at install time. Secure Boot can be enabled after installation to … Thu, 30 Apr 2026 00:00:00 GMT Security Shrinivas Kumbhar https://docs.shani.dev/doc/security/tpm2/ https://docs.shani.dev/doc/security/tpm2/ TPM2 Enrollment TPM2 enrollment seals your LUKS2 disk encryption key into your machine's Trusted Platform Module. Once enrolled, the disk unlocks automati… Thu, 30 Apr 2026 00:00:00 GMT Security Shrinivas Kumbhar https://docs.shani.dev/doc/networking/ip-addressing/ https://docs.shani.dev/doc/networking/ip-addressing/ IP Addressing & Routing This page covers IP addressing fundamentals — CIDR notation, subnetting, IPv4 and IPv6 — and practical command usage for managing… Tue, 28 Apr 2026 00:00:00 GMT Networking Shrinivas Kumbhar https://docs.shani.dev/doc/system/hardware/ https://docs.shani.dev/doc/system/hardware/ Hardware This page covers inspecting and diagnosing hardware on Shani OS: CPUs, memory, GPUs, storage controllers, USB devices, sensors, and firmware. All… Tue, 28 Apr 2026 00:00:00 GMT System Shrinivas Kumbhar https://docs.shani.dev/doc/system/kernel-modules/ https://docs.shani.dev/doc/system/kernel-modules/ Kernel Modules Kernel modules are loadable drivers and extensions that the Linux kernel can load and unload at runtime without rebooting. On Shani OS, mod… Tue, 28 Apr 2026 00:00:00 GMT System Shrinivas Kumbhar https://docs.shani.dev/doc/system/logging/ https://docs.shani.dev/doc/system/logging/ Logging Shani OS uses systemd-journald as its primary logging system. All kernel messages, service output, and system events flow into a single structured… Tue, 28 Apr 2026 00:00:00 GMT System Shrinivas Kumbhar https://docs.shani.dev/doc/system/storage/ https://docs.shani.dev/doc/system/storage/ Storage This page covers raw disk and block-device management on Shani OS: inspecting drives, partitioning, filesystem operations, SMART health monitoring… Tue, 28 Apr 2026 00:00:00 GMT System Shrinivas Kumbhar https://docs.shani.dev/doc/concepts/atomic-updates/ https://docs.shani.dev/doc/concepts/atomic-updates/ Atomic Updates Shanios uses an intelligent multi-layered update system with automatic checking, user notifications, and the tool for atomic system update… Mon, 27 Apr 2026 00:00:00 GMT Concepts Shrinivas Kumbhar https://docs.shani.dev/doc/enterprise/fleet/ https://docs.shani.dev/doc/enterprise/fleet/ OEM & Fleet Deployment Shanios is designed for fleet-scale management. Every machine pulls from the same GPG-verified image. Updates are atomic and all-or… Mon, 27 Apr 2026 00:00:00 GMT Enterprise Shrinivas Kumbhar https://docs.shani.dev/doc/intro/getting-started/ https://docs.shani.dev/doc/intro/getting-started/ Getting Started A complete walkthrough: choose your edition, download and verify the ISO, install, and configure Shanios for daily use. Choosing Your Edi… Mon, 27 Apr 2026 00:00:00 GMT Introduction Shrinivas Kumbhar https://docs.shani.dev/doc/intro/what-is-shanios/ https://docs.shani.dev/doc/intro/what-is-shanios/ What is Shanios? Shanios is an immutable Linux distribution that brings enterprise DevOps practices to desktop computing. Built on Arch Linux with Btrfs f… Mon, 27 Apr 2026 00:00:00 GMT Introduction Shrinivas Kumbhar https://docs.shani.dev/doc/overview/ https://docs.shani.dev/doc/overview/ Shanios Technical Documentation Comprehensive guide to the immutable Linux OS with atomic updates. Welcome to the Shanios technical documentation. This w… Mon, 27 Apr 2026 00:00:00 GMT Overview Shrinivas Kumbhar https://docs.shani.dev/doc/security/features/ https://docs.shani.dev/doc/security/features/ Security Features Shanios implements defence-in-depth security across every layer — from firmware to userspace. All features are active from first boot wi… Mon, 27 Apr 2026 00:00:00 GMT Security Shrinivas Kumbhar https://docs.shani.dev/doc/servers/kubernetes/ https://docs.shani.dev/doc/servers/kubernetes/ Portability note: Compose examples use rootless Podman and . When using Docker, replace with and with . All concepts, architecture patterns, and CLI com… Mon, 27 Apr 2026 00:00:00 GMT Self-Hosting & Servers Shrinivas Kumbhar https://docs.shani.dev/doc/networking/virtual-networking/ https://docs.shani.dev/doc/networking/virtual-networking/ Virtual Networking Linux exposes a rich set of virtual network devices and primitives for building software-defined networks, container networking, VMs, V… Sat, 25 Apr 2026 00:00:00 GMT Networking Shrinivas Kumbhar https://docs.shani.dev/doc/servers/openstack/ https://docs.shani.dev/doc/servers/openstack/ Portability note: Compose examples use rootless Podman and (the host gateway from a container). When using Docker, replace with and with (add to the … Sat, 25 Apr 2026 00:00:00 GMT Self-Hosting & Servers Shrinivas Kumbhar https://docs.shani.dev/doc/system/ch-commands/ https://docs.shani.dev/doc/system/ch-commands/ ch* Commands The family covers the core "change" utilities — tools that modify permissions, ownership, file attributes, and user account properties. All … Sat, 25 Apr 2026 00:00:00 GMT System Shrinivas Kumbhar https://docs.shani.dev/doc/system/process-management/ https://docs.shani.dev/doc/system/process-management/ Process Management Standard Linux process management tools are all available on Shani OS. This page covers inspecting, controlling, and debugging running … Sat, 25 Apr 2026 00:00:00 GMT System Shrinivas Kumbhar https://docs.shani.dev/doc/system/systemd/ https://docs.shani.dev/doc/system/systemd/ Systemd Systemd is the init system and service manager on Shani OS. It starts every process at boot, manages all daemons, handles logging via the journal,… Sat, 25 Apr 2026 00:00:00 GMT System Shrinivas Kumbhar https://docs.shani.dev/doc/system/users-groups/ https://docs.shani.dev/doc/system/users-groups/ Users & Groups User accounts on Shani OS follow standard Linux conventions — accounts are stored in , , and , which live in the overlay and persist acros… Sat, 25 Apr 2026 00:00:00 GMT System Shrinivas Kumbhar