ewan/nix-starter
1
mirror of https://github.com/ewanc26/nix-starter.git synced 2026-07-21 15:33:20 +00:00
Code Issues Projects Wiki Activity
Mirror of github.com/ewanc26/nix-starter
13 commits 1 branch 7 tags 74 KiB
  • Nix 100%
Find a file
Exact
Ewan Croft 2a3fb4ce95 docs: correct agent guidance after source audit
2026-07-16 18:22:46 +01:00
hosts add pds-gatekeeper module, consolidate pds config into pdsConfig 2026-03-14 15:16:38 +00:00
.pre-commit-config.yaml docs: add comments to source files 2026-06-29 22:00:17 +01:00
AGENTS.md docs: correct agent guidance after source audit 2026-07-16 18:22:46 +01:00
flake.lock fix flake check errors and deprecation warnings 2026-03-11 11:45:53 +00:00
flake.nix docs: add comments to source files 2026-06-29 22:00:17 +01:00
LICENSE Initial commit 2026-03-11 10:32:41 +00:00
README.md Update README with Tangled mirror link and current project details 2026-04-25 00:06:14 +01:00

README.md

nix-starter

https://github.com/ewanc26/nix-starter

Beginner-friendly, self-contained NixOS configurations.
No personal infrastructure, no shared abstractions — just plain NixOS.

🧶 Also available on Tangled

Hosts

Host Description
as-the-gods-intended Minimal TUI laptop, optional KDE Plasma desktop
server Hardened server — AT Protocol PDS + Mastodon via Cloudflare Tunnel

Structure

flake.nix                        — top-level flake, wires up all hosts
hosts/
├── as-the-gods-intended/
│   ├── default.nix              — system config (boot, networking, packages)
│   ├── home.nix                 — user config (shell, editor, tools)
│   ├── hardware-configuration.nix  — generated per-machine, replace before install
│   └── README.md                — full setup guide for that host
└── server/
    ├── default.nix              — host skeleton (boot, networking, SSH, nginx, nix)
    ├── hardware-configuration.nix  — generated per-machine, replace before install
    ├── README.md                — full setup, secrets, and tunnel guide
    └── modules/
        ├── cloudflare-tunnel.nix   — outbound tunnel, ingress rules for both services
        ├── pds.nix                 — bluesky-pds + nginx vhost
        └── mastodon.nix            — Mastodon + nginx vhost overrides

Adding a new host

  1. Copy an existing host directory as a starting point: 
    cp -r hosts/as-the-gods-intended hosts/my-new-host
  2. Update networking.hostName, the username, and the hardware config.
  3. Add an entry to flake.nix under nixosConfigurations.
  4. Follow the setup guide in the new host's README.md.

Resources