nixos

NixOS is more complicated than you think but opencode fixed it

Luigi

• 2 min read
Share

Overview

A deep dive into an advanced, minimal NixOS setup using LabWC (Wayland compositor) + Noctalia Shell V5 (from Cachix, not the official NixOS repo), assisted by opencode with the DeepSeek V4 Flash model for AI-guided configuration.

The result? A desktop that boots at 743 MB RAM with only 48 active tasks.

Key Highlights

🔹 Ultra-lightweight

  • 743 MB RAM usage on boot
  • 48 tasks active — no bloat from full DEs like GNOME or KDE

🔹 LabWC + Noctalia V5

  • LabWC provides a minimal Wayland session; many desktop services (dbus, polkit, clipman, etc.) must be manually configured
  • Noctalia Shell V5 sourced via Cachix (not yet in nixpkgs)
  • Color schemes sync between Nocttalia and LabWC via noctalia-labwc-sync

🔹 AI-Assisted Config

  • opencode + DeepSeek V4 Flash used to write and debug NixOS configs
  • AGENTS.md drives system updates and automation
  • Sudoers configured for passwordless sudo (opencode convenience)

🔹 Custom Patches

  • Snapshot (webcam app) patched to work on NixOS — needed a custom build with a library fix, despite being in nixpkgs
  • Several environment variables manually set (session type, compose key, Telegram fix) since LabWC/greetd don't handle them all

🔹 No Home-Manager

  • User configs kept in ~/.config/ for portability across distros
  • A rebuild hook symlinks dotfiles into /etc/nixos/ (like GNU Stow)

🔹 Hybrid Package Management

  • Nix packages via environment.systemPackages
  • npm-installed apps like opencode2 coexist alongside Nix-managed ones
  • Some programs (e.g., OBS Studio) enabled via programs.obs-studio.enable rather than packages list

Notable Services & Tools

Service/Tool Purpose
greetd Login manager (alternative to GDM/SDDM)
vox-type (Vulkan) Speech-to-text, Italian primary
podman + podman-compose Container management
cockpit + cockpit-podman Web admin UI
kshi Display resolution & multi-monitor
clipman Persistent clipboard
satty Screenshots
scrcpy Android screen mirror via USB
smartmontools SSD health analysis
LocalSend LAN file sharing (port 53317)
KDE Connect Device integration
Traefik Reverse proxy (podman container)

NixOS Config Structure

/etc/nixos/
├── flake.nix          → loads configuration.nix + Nocttalia V5
├── configuration.nix  → main config (long, modular)
├── hardware-configuration.nix
└── *symlinks → ~/dotfiles/ (managed via rebuild hook)

Lessons & Gotchas

  1. LabWC is not a full DE — you must manually wire up dbus, polkit, clipboard, environment variables, etc.
  2. greetd doesn't fully manage session env vars — some must be hardcoded in config
  3. Snapshot needs a patch on NixOS even if available in repos
  4. Nix sometimes misidentifies apps — file associations can be tricky
  5. 4 GB+ RAM recommended for nixos-rebuild — a swap file helps on low-RAM machines
  6. AMD microcode + Bluetooth disabled at boot (but installed) — fine-grained control

Final Thought

"Some configurations are very complicated — but it is worth exploring this path."

The trade-off is clear: more complexity upfront for a lean, reproducible, extremely lightweight system. opencode + AI bridging the gap makes it practical.