Clan is a toolkit that makes it easier to manage networks of VPN-connected NixOS machines.
The ultimate goal is to lower the barrier to self-hosted services massively and allow anyone to achieve this without special hardware. As of now, using Clan still requires NixOS knowledge, but it already combines several of our Open-Source projects that you may know (nixos-anywhere, sops-nix, nixos-generators, disko, …) into a uniform CLI.
Changelog
Networking / External Peers
- Interface to add external peers (phones/machines not in the clan) #5543 — pending review and close to merging.
- Ability to generate QR codes for external peers — work in progress.
Matrix / Communications
- Upgraded the clan.lol Matrix channel (security update; details: Matrix.org - Security Release).
- Aware of migration hiccups; outreach ongoing to help everyone transition smoothly.
Nix / Infrastructure
- Bumped nixpkgs input in clan-core #5211.
- New Binary Cache at https://cache.clan.lol (HA on Hetzner S3 + Fastly CDN, GC enabled).
- Runs GitHub - Mic92/niks3: Nix binary caches based on S3-compatible storage.
- Improves reliability during infra work and makes CI/uploads more resilient.
- First NixOS Facter module merged into Nixpkgs — nixos/facter: add initial commit by Mic92 · Pull Request #450303 · NixOS/nixpkgs · GitHub
Releases
- Started work on first stable release of clan-core
- Adopting a NixOS-style stable/unstable pattern, starting with NixOS 25.11.
App / GUI & Mobile
- Mobile PoC:
- Design experiments for a better mobile experience.
- Validated there are no technical blockers with the orthographic view.
- Storybook tests for the App now running in CI, expanded with visual render tests.
- Switched App font to Geist #5508, #5574 — resolves legibility issues tracked in #5248.
Inventory / Persistence
CLI / Tooling
- Added a test for oneOf introspection #5432.
- Fixed dynamic shell completions and improved the CLI completions testing framework #5599.
- Fixed extraPythonPackages support in the container-test-driver #5491:
- Closer to upstream usage; uses the correct callPackage pattern.
- Systemd abstraction work #5382.
- Prototype LLM/AI integration with the CLI #5489.
Libraries
- New library to simplify creating wrapped executables via the module system: GitHub - Lassulus/wrappers
- Enables configuring non-NixOS systems (Android, macOS, unprivileged NixOS, BSD, …) to work with Clan services in the future.
Clan Services
- Added a desktop Clan service for easy KDE/Plasma setup #5487.
- Collected and documented community Clan services:
- Includes multiple services provided outside the official repo to encourage contributions and real-world examples.
- Started designing a better monitoring service.
Docs