synapse/goatcounter-stats-gateway
1
0
Fork 0
Code Issues Pull requests Projects Releases 6 Packages Wiki Activity Actions

docs: installation guide (README + book chapter) #12

Merged
synapse merged 1 commit from docs/installation into develop 2026-08-21 20:45:52 +00:00
Conversation 0 Commits 1 Files changed 4 +166 -6
synapse commented 2026-08-21 20:40:32 +00:00
Owner
Copy link

Installation story, written for strangers:

  • README: new Install section — NixOS (flake input + module, 10 lines to running), static binary path, client via npm and CDN script tag — plus a Status refresh reflecting v0.2.0 and the npm package.
  • Book: new Installation chapter (before Configuration): full NixOS walkthrough, the two binary-cache trust layers explained (flake nixConfig for anyone who clones vs nix.settings for owned fleets — either alone suffices, answering the "do we still need the flake's nixConfig?" question in docs form), checksum-verified static-binary install, and a hardened systemd unit example for non-NixOS hosts that carries the AF_UNIX/journald lesson forward.

Docs-only change; book builds clean.

🤖 Generated with Claude Code

https://claude.ai/code/session_01T5j3dAJVcUjZv9k76sRTt9

Installation story, written for strangers: - **README**: new Install section — NixOS (flake input + module, 10 lines to running), static binary path, client via npm and CDN script tag — plus a Status refresh reflecting v0.2.0 and the npm package. - **Book**: new Installation chapter (before Configuration): full NixOS walkthrough, the two binary-cache trust layers explained (flake `nixConfig` for anyone who clones vs `nix.settings` for owned fleets — either alone suffices, answering the "do we still need the flake's nixConfig?" question in docs form), checksum-verified static-binary install, and a hardened systemd unit example for non-NixOS hosts that carries the AF_UNIX/journald lesson forward. Docs-only change; book builds clean. 🤖 Generated with [Claude Code](https://claude.com/claude-code) https://claude.ai/code/session_01T5j3dAJVcUjZv9k76sRTt9
docs: installation guide — README quickstart + full book chapter
All checks were successful
ci / gate (pull_request) Successful in 23s
Details
9207f2f3df
 
README gains an Install section (NixOS flake+module, static binary,
client via npm/CDN) and a refreshed Status; new Installation chapter
covers both paths in detail incl. the binary-cache trust layers (flake
nixConfig for strangers, nix.settings for owned fleets — either alone
suffices) and a hardened systemd unit example for non-NixOS hosts
(AF_UNIX lesson included).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01T5j3dAJVcUjZv9k76sRTt9
synapse merged commit 800f91085c into develop 2026-08-21 20:45:52 +00:00
synapse deleted branch docs/installation 2026-08-21 20:45:53 +00:00
Sign in to join this conversation.
Reviewers
No reviewers
Labels
Clear labels
No items
No labels
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
synapse/goatcounter-stats-gateway!12
No description provided.