Files
pinpox e8a6e88ea1 templates/clan: rewrite default template, use age vars backend
The default and flake-parts templates used by `clan init` now select the
age secret store and list the admin's age public key in
vars.settings.recipients.default. `clan init` / `clan flakes create`
select or generate the admin key before creating the clan and pass it
to create_clan; a sops user is only created when the resulting clan
uses the sops backend (e.g. the minimal template).

Template contents:
- document age plugins (yubikey, tpm, bip39) and per-machine recipients
- reach machines via p2p-ssh-iroh; add a commented internet instance for
  servers with a fixed address
- explain inventory.machines and the sshd instance
- generate the root password instead of prompting
- drop the unused gnome module and the pkgsForSystem example

The users service now defaults `prompt` to false, so the templates use
the one-line `roles.default.settings.user = "root";`.

Getting-started guides for local machines no longer ask for the
post-install IP address and no longer prompt for a root password.
2026-10-07 14:39:26 +02:00
..
2026-04-12 20:08:43 +08:00
2024-07-08 16:24:34 +02:00
2026-04-14 15:20:50 +08:00
2026-04-15 20:31:18 +08:00

Documentation

Local Development

Enter the docs dev shell (from the docs/ directory, direnv will activate automatically):

cd docs

Or manually:

nix develop .#docs

Then start the dev server with hot module reloading:

clan-site

This watches docs/src/ for markdown changes and automatically reloads the browser.

Add -b to open the site in a new browser tab:

clan-site dev -b

Building

To create a production version of the site:

clan-site build