GitHub - ecklf/dotfiles: Darwin / NixOS Configurations

Darwin

Setup

1: Checklist

Run the following checklist script to prepare your system for using this repository:

2: Configure SSH

Generate a new one if needed:

cd ~/.ssh
ssh-keygen -C "your_email@example.com"
ssh-add ~/.ssh/id_ed25519

Add your key to ~/.ssh/config and to your GitHub account:

Host github.com
  IdentityFile ~/.ssh/id_ed25519

Using this repository

Important

For the very first run, darwin-rebuild won't be installed in your path

Values for {SYSTEM} can be found in darwinConfigurations in flake.nix

nix run nix-darwin --extra-experimental-features flakes --extra-experimental-features nix-command -- switch --flake ~/dotfiles#{SYSTEM}

# Build configuration
darwin-rebuild build --flake ~/dotfiles#{SYSTEM}
# Build and switch configuration
darwin-rebuild switch --flake ~/dotfiles#{SYSTEM}

NixOS

Setup

1: Download ISO image, flash it to USB, and boot

2: Setup Wireless (optional)

sudo systemctl start wpa_supplicant
wpa_cli
> scan
> scan_results
> add_network
> 0
> set_network 0 ssid "NETWORK_SSID"
> set_network 0 psk "NETWORK_SECRET"
> enable_network 0
> quit
ip a
ping google.com

3: Partition Disks

These steps are for a UEFI system with GPT partitioning. Adjust as needed.

Important

Ensure the label steps for NIXROOT and NIXBOOT are not skipped as they are used in the configuration.

# Identify disk
lsblk
# Partition disk
sudo fdisk /dev/sdX
> g (gpt disk label)
> n
> 1 (partition number [1/128])
> 2048 first sector
> +500M last sector (boot sector size)
> t
> 1 (EFI System)
> n
> 2
> default (fill up partition)
> default (fill up partition)
> w (write)
# Create file systems
sudo mkfs.fat -F 32 /dev/sdX1
sudo fatlabel /dev/sdX1 NIXBOOT
sudo mkfs.ext4 /dev/sdX2 -L NIXROOT
sudo mount /dev/disk/by-label/NIXROOT /mnt
sudo mkdir -p /mnt/boot
sudo mount /dev/disk/by-label/NIXBOOT /mnt/boot
# Create swap file
sudo dd if=/dev/zero of=/mnt/.swapfile bs=1024 count=2097152 (2GB size)
sudo chmod 600 /mnt/.swapfile
sudo mkswap /mnt/.swapfile
sudo swapon /mnt/.swapfile

4: Installation

sudo nixos-generate-config --root /mnt
cd /mnt
sudo nixos-install

5: Add nix channels

# Add home-manager channel (update version if needed)
sudo nix-channel --add https://github.com/nix-community/home-manager/archive/release-24.05.tar.gz home-manager
sudo nix-channel --update

Using this repository

# Build configuration (for {SYSTEM} see `nixosConfigurations` in flake.nix)
sudo nixos-rebuild build --flake ~/dotfiles#{SYSTEM}
# Build and switch configuration (for {SYSTEM} see `nixosConfigurations` in flake.nix)
sudo nixos-rebuild switch --flake ~/dotfiles#{SYSTEM}

Post Install

Important

Update your user password

Set up Samba if used by configuration:

# See user info
sudo pdbedit -L -v
# Add samba password
sudo smbpasswd -a $(whoami) 
# Debug samba issues
sudo systemctl status mnt-share.mount

Updating inputs

# Upgrading nix — https://nix.dev/manual/nix/2.22/installation/upgrading
# Updating flake inputs
nix flake update 
nix flake update <input>