Skip to content
dotfiles

Getting Started

This repository is personal infrastructure. Treat it as a reference first, then copy patterns into your own configuration deliberately.

Prerequisites

Section titled “Prerequisites”
  • Nix with nix-command and flakes enabled
  • Git
  • just for the documented command shortcuts
  • Host-specific hardware and disk configuration for any real NixOS install
  • Access to the required SOPS keys if you want to deploy this exact repository

Clone

Section titled “Clone”
Terminal window
git clone https://github.com/Gandharikos/dotfiles ~/.dotfiles
cd ~/.dotfiles

Inspect Available Commands

Section titled “Inspect Available Commands”
Terminal window
just

The most common commands are:

Terminal window
just switch <host>
just test <host>
just deploy <host>
just check
just fmt

Build Before Switching

Section titled “Build Before Switching”

Run a non-destructive build or test first:

Terminal window
just test <host>

Only switch after you have verified host names, hardware settings, disk layout, and secret access.

Documentation Site

Section titled “Documentation Site”

Run the docs locally:

Terminal window
cd docs
npm install
npm run dev

Build static docs:

Terminal window
npm run build