Skip to content
WikiGen's Config Documentation

Quickstart Guide

Get your Nix configuration up and running in 5 minutes.

Prerequisites

Section titled “Prerequisites”
  • macOS system (for Darwin setup)
  • Terminal access
  • 10 GB free disk space

Step 1: Install Nix (2 minutes)

Section titled “Step 1: Install Nix (2 minutes)”

Use the Determinate Systems installer for the best experience:

Terminal window
curl -fsSL https://install.determinate.systems/nix | sh -s -- install --determinate

Why Determinate Nix?

  • Includes flakes by default
  • Better macOS support
  • No daemon management needed

Step 2: Install Homebrew (1 minute)

Section titled “Step 2: Install Homebrew (1 minute)”

Required for macOS-specific GUI apps:

Terminal window
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Step 3: Clone This Config (1 minute)

Section titled “Step 3: Clone This Config (1 minute)”
Terminal window
cd ~
git clone https://github.com/yourusername/Config.git
cd Config

Step 4: Apply Configuration (1 minute)

Section titled “Step 4: Apply Configuration (1 minute)”

First-Time Setup

Section titled “First-Time Setup”
Terminal window
# Backup existing shell config
mv ~/.zshrc ~/.zshrc.backup 2>/dev/null || true


# Apply Nix configuration
sudo nix run nix-darwin -- switch --flake .#wikigen-mac

Subsequent Updates

Section titled “Subsequent Updates”

After the first setup, use:

Terminal window
darwin-rebuild switch --flake .#wikigen-mac

What You Just Got

Section titled “What You Just Got”

✅ System Packages

  • Nix development tools (git, vim, curl, wget)
  • Cloud CLIs (AWS, GCP, Kubernetes)
  • Container tools (Colima, Docker, Skopeo)
  • AI tools (Claude Code, MCP Inspector)

✅ Hardware Security (optional setup)

  • Ledger wallet support
  • GPG signing
  • SSH authentication
  • SOPS secrets management

✅ Shell Configuration

  • Zsh with completions
  • Colima auto-start
  • GPG/SSH agent integration

Quick Verification

Section titled “Quick Verification”
Terminal window
# Check Nix installation
nix --version


# Check installed packages
which aws kubectl docker


# View system configuration
darwin-rebuild --help

Next Steps

Section titled “Next Steps”
  1. Customize for your machine - Edit hosts/wikigen-mac.nix with your username
  2. Set up Ledger - See Ledger Setup Guide
  3. Add secrets - See SOPS Guide
  4. Explore structure - Read Architecture Guide

Troubleshooting

Section titled “Troubleshooting”

”Command not found” after install

Section titled “”Command not found” after install”

Restart your shell:

Terminal window
exec zsh

Homebrew not found

Section titled “Homebrew not found”

Add to PATH:

Terminal window
eval "$(/opt/homebrew/bin/brew shellenv)"

Build fails with version mismatch

Section titled “Build fails with version mismatch”

Ensure you’re using the latest flake lock:

Terminal window
nix flake update
darwin-rebuild switch --flake .#wikigen-mac

Common First Tasks

Section titled “Common First Tasks”

Add a package:

# In hosts/wikigen-mac.nix
environment.systemPackages = with pkgs; [
  # ... existing packages
  htop  # Add your package here
];

Rebuild:

Terminal window
darwin-rebuild switch --flake .#wikigen-mac
Section titled “Related Documentation”

Get Help

Section titled “Get Help”

You’re all set! 🚀

Continue with First Steps to learn how to customize your setup.