Go to file

Melvin Ragusa 2505298449 Normalize Nix module formatting and update flake.lock

Consistently format module argument blocks and convert aligned
package comments to inline comments. Trim trailing whitespace and
minor layout tweaks across modules. Bump opencode rev, narHash and
lastModified in flake.lock and remove the original dev ref.

2026-02-02 18:08:01 +01:00

.config

add: .config

2026-02-02 14:58:13 +01:00

modules

Normalize Nix module formatting and update flake.lock

2026-02-02 18:08:01 +01:00

.gitconfig

add: .config

2026-02-02 14:58:13 +01:00

.gitignore

add: .config

2026-02-02 14:58:13 +01:00

configuration.nix

Bump NixOS stateVersion to 26.05

2026-02-02 17:58:28 +01:00

flake.lock

Normalize Nix module formatting and update flake.lock

2026-02-02 18:08:01 +01:00

flake.nix

Use opencode default ref and tidy outputs

2026-02-02 18:02:43 +01:00

hardware-configuration.nix

update: hardware-configuration.nix

2026-02-02 16:17:46 +01:00

pacman.txt

add: pacman list

2026-02-02 11:20:24 +01:00

README.md

update: README.md install guide

2026-02-02 11:43:58 +01:00

README.md

atlas - NixOS configuration

Personal NixOS desktop configuration built with Nix flakes for x86_64-linux. The setup is modular and targets a Wayland desktop (Niri + Ly) with PipeWire audio, AMD GPU support, and a curated set of apps and developer tooling.

Highlights

Wayland desktop: Niri compositor, Ly display manager, portals, Polkit agent
Audio: PipeWire (ALSA, PulseAudio, JACK)
AMD GPU stack: Vulkan, VA-API, CoreCtrl
Developer tooling: Docker, Rust, Node.js, Python
Extras: Steam/Gaming, virtualization, theming, Navidrome

Prerequisites

A recent NixOS installer ISO with flake support
x86_64-linux hardware (this flake is pinned to that system)
Basic familiarity with the NixOS installation process

This is a personal configuration. Expect to adjust the hostname, user, and hardware modules for your machine.

Installation (fresh NixOS install)

Download and boot the NixOS graphical installer
- https://nixos.org/download.html
Follow the graphical installer
- Partition your drives as needed
- Create your user account
- When prompted for desktop environment, select No desktop
- Complete the installation
Reboot and log in to your new shell-only NixOS system

Clone this repository

git clone https://github.com/ragusa-it/nixos ~/nixos

Copy your hardware configuration into the repo

cp /etc/nixos/hardware-configuration.nix ~/nixos/hardware-configuration.nix

Review and customize
- configuration.nix
  - networking.hostName
  - users.users.pinj (change username/groups as needed)
- modules/gpu-amd.nix if you are not on AMD hardware

Rebuild with the flake

sudo nixos-rebuild switch --flake ~/nixos#nixos

Reboot to start the full desktop environment
```
sudo reboot
```

Post-install rebuilds

From inside the cloned repository:

sudo nixos-rebuild switch --flake .#nixos

Use boot if you want to schedule the change for the next reboot:

sudo nixos-rebuild boot --flake .#nixos

Updating the system

nix flake update
sudo nixos-rebuild switch --flake .#nixos

Repository layout

flake.nix - Flake inputs, binary caches, and system definition
configuration.nix - Main NixOS entry point (imports modules)
hardware-configuration.nix - Machine-specific hardware config (replace on install)
modules/ - Modular system features
- desktop.nix - portals, Polkit agent, swaylock, swayidle
- gpu-amd.nix - AMD GPU stack
- audio.nix - PipeWire and Bluetooth
- apps.nix - user applications
- dev.nix - developer tooling
- gaming.nix - Steam, Lutris, Gamemode
- theming.nix - fonts, themes, cursors
- virtualization.nix - QEMU/KVM/virt-manager
- power.nix - power management
- shell.nix - Fish shell configuration
- services.nix - system services (fstrim, zram, avahi)
- navidrome.nix - self-hosted music server

Troubleshooting

Flakes not enabled: if nixos-rebuild fails, prefix the command with NIX_CONFIG="experimental-features = nix-command flakes" or enable flakes in /etc/nix/nix.conf.
Wrong hardware configuration: regenerate with sudo nixos-generate-config and copy the new hardware-configuration.nix into the repo.

License

No license is specified. If you plan to reuse this configuration, please open an issue to discuss licensing.