AvyOS

Immutable. Lightweight. Blazing Fast.

AvyOS is an immutable Linux distribution built from scratch using OSTree, optimized for speed, stability, and a beautifully customized XFCE desktop.

AvyOS running on laptop

What is AvyOS?

AvyOS is an independent operating system based on Linux kernel designed for long-term stability and reliability. The name comes from the Sanskrit term Avyaya (अव्यय), meaning “unchanging” or “immutable.” AvyOS protects the core system from accidental changes and delivers safe, predictable updates using OSTree.

Core Features

Immutable Core

OSTree-based immutable system that prevents accidental breakage.

Extreme Performance

Built from scratch and optimized for real, noticeable speed.

Customized XFCE

Lightweight, responsive, and beautifully tuned desktop environment.

Flatpak & Distrobox

Run apps from any distribution without touching the base system.

Sysroot Extensions

Add drivers and desktops safely without compromising stability.

Secure by Design

Immutable architecture enables safe rollbacks and recovery.

AvyOS in Action

A beautifully customized XFCE desktop lightweight, responsive, and optimized for speed without sacrificing aesthetics.

AvyOS desktop overview

Desktop Overview

Clean XFCE layout with custom theming and fast panel response.

AvyOS application launcher

Application Launcher

Fast, minimal app menu designed for keyboard and mouse users.

AvyOS terminal and performance

Speed & Performance

Instant app launches and low resource usage on real hardware.

Why AvyOS?

Immutable, Explained

Immutable Linux distributions keep the core operating system read-only and consistent. Instead of modifying the live system package by package, the OS is built and tested as a complete image and updated atomically. This prevents partial upgrades, dependency conflicts, and system breakage.

✔ Advantages

  • • Predictable and consistent system state
  • • No partial upgrades or broken dependencies
  • • Atomic updates with safe rollback
  • • Stronger stability and reliability
  • • Lower risk of accidental system damage

⚠ Trade-offs

  • • Core system cannot be modified directly
  • • Updates typically require a reboot
  • • Different workflow than traditional distros
  • • Less suitable for heavy system tinkering
  • • Larger updates due to full image replacement

AvyOS embraces these trade-offs while restoring flexibility through Flatpak, Distrobox, and controlled system extensions keeping the base stable without limiting user workflows.

Package-Based Distributions

  • • System assembled package by package
  • • Independent package updates
  • • Dependency mismatches are common
  • • Partial upgrades can break the system
❌ Inconsistent system state

Tradition Immutable Distro

  • • Packages frozen at fixed versions
  • • Reduced update frequency
  • • Still built as individual packages
  • • Inconsistencies can accumulate over time
⚠ More stable, but not fully consistent

AvyOS (Image-Based Immutable)

  • • Entire OS built as a single image
  • • All components tested together
  • • Atomic updates only
  • • Reliable rollback on failure
✅ Fully consistent by design

Why AvyOS Is Built From Scratch

Most Linux distributions assemble systems from independently built packages. Even when versions are frozen, those packages are rarely built or tested together as a single, unified system.

AvyOS uses an image-based build process where the entire system is integrated, built, and validated in one pipeline. This eliminates subtle incompatibilities and prevents package-level breakage.

The result is a system that remains stable and predictable across updates aligned with the meaning of Avyaya: that which does not change.

Limitations (By Design)

AvyOS makes deliberate design choices to ensure stability and consistency. These limitations are intentional and rarely affect day-to-day usage.

No Traditional Package Managers

AvyOS is not based on Debian, Fedora, or Arch. As a result, system-level package managers like apt, dnf, or pacman are not available.

Instead, applications are installed using Flatpak or Extensions and full development environments can be created using Distrobox.

Read-Only Root Filesystem

The root filesystem (/) is read-only by default. This prevents accidental system modification and keeps the OS in a known, reliable state.

Most users never need to modify the root filesystem. Configuration, applications, and development workflows live outside the immutable base.

These constraints exist to protect the system. AvyOS prioritizes stability at the core, while providing flexibility on top so you can focus on using your system, not fixing it.

Get Involved with AvyOS

AvyOS is a community-driven, open-source Linux distribution. Whether you write code, test builds, design interfaces, or document systems your contribution matters.

💻 Code

Help improve the core system, tooling, OSTree integration, or build infrastructure.

  • • Fix bugs & optimize performance
  • • Improve immutable workflows
  • • Review and improve code quality

🧪 Test

Test AvyOS on different hardware and report issues to improve stability and compatibility.

  • • Test on laptops & desktops
  • • Verify driver & Flatpak support
  • • Report regressions

🎨 Design

Shape the visual identity of AvyOS from themes and icons to the desktop layout.

  • • XFCE theming & UI polish
  • • Branding & wallpapers
  • • Accessibility improvements

📘 Documentation

Clear documentation makes AvyOS accessible to users and contributors alike.

  • • Installation guides
  • • Immutable system concepts
  • • Developer onboarding

🌍 Community

Help grow a welcoming, respectful community around AvyOS.

  • • Answer questions
  • • Help new contributors
  • • Moderate discussions

🚀 How to Start

  1. Fork the AvyOS repository
  2. Read the contribution guidelines
  3. Pick a good first issue
  4. Submit a pull request