Argo OS
A custom Gentoo distribution built for performance, stability, and sanity
Three months, 200+ hours, and one existential crisis with Qt6 later—this is what emerged.
What is Argo OS?
Argo OS is what happens when you get tired of waiting 6 hours for Firefox to compile. It's a custom Gentoo-based distribution designed to rival:
- CachyOS for gaming performance
- Fedora/Debian for security
- openSUSE for stability and snapshot protection
The difference? Argo OS compiles everything once on a build server, then deploys binary packages everywhere. Updates take minutes instead of hours. And if something breaks? Roll back in 2 minutes via Btrfs snapshots.
Core Design Principles
Compile Once, Deploy Everywhere
Binary package distribution from build servers. Your workstation never touches a compiler.
Snapshot Protection
Btrfs with automatic snapshots before and after every package operation. Rollback in 2 minutes.
Performance First
Optimized compilation with CPU-specific flags. No distribution compromises for compatibility.
Version Controlled
All configurations tracked in Git. Rebuild the entire system from source if needed.
Reproducible
Anyone should be able to build identical systems. Documentation is the product.
Cloud-Integrated
Automated backups and distributed storage. Your configs are never truly lost.
The Journey
Three months of building, breaking, and rebuilding. Here's how Argo OS evolved.
The VM Foundation
Built Gentoo in a VM. KDE Plasma, Firefox, the whole stack. 40 hours of compilation. Then the package database corrupted.
The Btrfs Migration
Rebuilt everything on Btrfs with Snapper. openSUSE's snapshot model, but on Gentoo. First successful rollback test: 2 minutes including reboot.
Binary Package Distribution
Set up a binhost server. Compile once, deploy everywhere. Updates went from 6 hours to 15 minutes. Game changer.
The Desktop Setup
KDE Plasma 6. Hyprland for tiling. NVIDIA drivers that actually work. The dream setup that took 3 weeks of dependency resolution.
The Build Swarm
One binhost wasn't enough. Built a distributed compilation system: 5 drones, 66 cores, packages built in parallel across multiple machines.
Production Ready
Daily driver for work and gaming. 4,700+ packages. Self-healing build infrastructure. Faster updates than Arch.
Technology Stack
Core System
Desktop
Infrastructure
Tooling
Key Features
90% Faster Updates
Binary packages mean updates in minutes, not hours. Firefox installs in 30 seconds instead of 4 hours.
2-Minute Rollback
Automatic snapshots before every package operation. Broke something? Boot into a previous snapshot from GRUB.
Distributed Builds
66 CPU cores across 5 machines compiling packages in parallel. Build the entire system from scratch in hours, not days.
No Compromises
Every package compiled with your exact CPU flags. No distribution-level compatibility compromises.
VM Portable
Deploy a complete system to a new VM in 15 minutes. Golden images for rapid testing and development.
Documented Obsessively
Every decision, every disaster, every solution—documented. The journey is the product.
By the Numbers
Explore More
Interested in Building Your Own?
Argo OS isn't a downloadable distro—it's a documented journey. The real value is in the process, the decisions, and the lessons learned.
Start with the blog series, fork the configs, and build something that's truly yours.