108 lines
2.5 KiB
Markdown
108 lines
2.5 KiB
Markdown
# Quick Start Guide
|
|
|
|
## TL;DR - Should I Use Flakes?
|
|
|
|
**YES!** ✅ Use flakes because:
|
|
|
|
1. You get **nixos-unstable** (latest packages) with reproducibility
|
|
2. Your config is in **git** with locked versions (flake.lock)
|
|
3. You **already have flakes enabled** in your system
|
|
4. It's the **modern, recommended approach**
|
|
|
|
## Current vs Flake Setup
|
|
|
|
### Current (Channels) ❌
|
|
```bash
|
|
# Update
|
|
sudo nix-channel --update
|
|
sudo nixos-rebuild switch
|
|
|
|
# Config location
|
|
/etc/nixos/configuration.nix
|
|
|
|
# Package versions
|
|
Whatever the channel has (not locked)
|
|
```
|
|
|
|
### With Flakes (Recommended) ✅
|
|
```bash
|
|
# Update
|
|
nix flake update
|
|
sudo nixos-rebuild switch --flake /home/pan/dev/config/dot/nix/nixos#nix --impure
|
|
|
|
# Config location
|
|
/home/pan/dev/config/dot/nix/nixos/
|
|
├── flake.nix (inputs: nixpkgs unstable, home-manager, nixos-wsl)
|
|
├── flake.lock (exact versions locked)
|
|
└── configuration.nix
|
|
|
|
# Package versions
|
|
Locked in flake.lock, reproducible everywhere
|
|
```
|
|
|
|
## Apply the Flake Configuration Now
|
|
|
|
### Step 1: Test it
|
|
```bash
|
|
cd /home/pan/dev/config/dot/nix/nixos
|
|
nix flake check --impure
|
|
sudo nixos-rebuild build --flake .#nix --impure
|
|
```
|
|
|
|
### Step 2: If successful, apply it
|
|
```bash
|
|
sudo nixos-rebuild switch --flake .#nix --impure
|
|
```
|
|
|
|
### Step 3: Verify
|
|
```bash
|
|
nixos-version
|
|
nix flake metadata /home/pan/dev/config/dot/nix/nixos
|
|
```
|
|
|
|
## What Changes?
|
|
|
|
- ✅ Same packages, just from nixos-unstable (usually newer)
|
|
- ✅ Same home-manager config (all your dotfiles stay)
|
|
- ✅ Same NixOS-WSL functionality
|
|
- ✅ Exact versions locked in flake.lock
|
|
- ✅ Easy to rollback (NixOS generations)
|
|
|
|
## Daily Usage
|
|
|
|
```bash
|
|
# Make config changes
|
|
vim /home/pan/dev/config/dot/nix/nixos/home.nix
|
|
|
|
# Apply
|
|
sudo nixos-rebuild switch --flake /home/pan/dev/config/dot/nix/nixos#nix --impure
|
|
|
|
# Update packages (weekly/monthly)
|
|
cd /home/pan/dev/config/dot/nix/nixos
|
|
nix flake update
|
|
sudo nixos-rebuild switch --flake .#nix --impure
|
|
|
|
# Rollback if needed
|
|
sudo nixos-rebuild switch --rollback
|
|
```
|
|
|
|
## Create Convenience Alias
|
|
|
|
Add to your `~/.zshrc` or shell config:
|
|
|
|
```bash
|
|
# Quick rebuild
|
|
alias nr='sudo nixos-rebuild switch --flake /home/pan/dev/config/dot/nix/nixos#nix --impure'
|
|
|
|
# Update and rebuild
|
|
alias nu='cd /home/pan/dev/config/dot/nix/nixos && nix flake update && sudo nixos-rebuild switch --flake .#nix --impure'
|
|
```
|
|
|
|
Then just run `nr` to rebuild!
|
|
|
|
## Need Help?
|
|
|
|
- Read [MIGRATION.md](MIGRATION.md) for detailed migration guide
|
|
- Read [README.md](README.md) for full documentation
|
|
- Check [TODO.md](TODO.md) for known issues
|