Complete guide for installing and configuring NixOS with River or MangoWC window managers.

• NixOS ISO (minimal or graphical)
• Internet connection
• Bootable USB drive with NixOS
• Basic Linux terminal knowledge

1. After a minimal NixOS installation, install git via nix-shell

nix-shell -p git

• Configure network (if needed):

# For WiFi
sudo systemctl start wpa_supplicant
wpa_cli

# For Ethernet (usually automatic)

2. Clone the repository:

# Temporarily in live environment
git clone https://github.com/jvssdev/NordValley.git
cd NordValley

3. Run the installer:

chmod +x install.sh
./install.sh

The script will:

• Request user information
• Install the complete system
• Configure everything automatically

After rebooting into the installed system:

cd ~/NordValley
./install.sh

Or manually:

# For River
sudo nixos-rebuild switch --flake .#river

# For MangoWC
sudo nixos-rebuild switch --flake .#mangowc

# Test the editor
hx

# Test the terminal
ghostty

# Check services
systemctl status

After installation:

~/NordValley/               # Main configuration
  ├── home/            # Configuration files
  ├── hosts/               # Per-host configurations
  ├── modules/             # NixOS modules
  └── flake.nix           # Entry point

## Customization

### Change Window Manager

```bash
# Rebuild with another WM
sudo nixos-rebuild switch --flake ~/NordValley#mangowc

cd ~/NordValley
nix flake update
sudo nixos-rebuild switch --flake .#river

Edit ~/NordValley/modules/packages.nix:

basePackages = [
  # Your packages here
  neovim
  git
  # ...
];

Then:

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

• Super + T: Open terminal
• Super + A: Launcher (Fuzzel)
• Super + Q: Close window
• Super + X: Power menu

• Ctrl + Shift + T: New tab
• Ctrl + Shift + W: Close tab
• Ctrl + Shift + C/V: Copy/Paste

• NixOS Manual
• Home Manager Manual
• River Documentation
• Helix Documentation

This project is under the MIT license.

Delete stale paths: nix-collect-garbage

Delete stale paths and generations older than x days: nix-collect-garbage --delete-older-than 30d