docs(okf): add server memory budget and analytics proposal
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
64fef83314
commit
261cf17e52
13 files changed
+178
-12
No files matched your search
@@ -0,0 +1,38 @@
|
||||
---
|
||||
type: Decision
|
||||
title: GoatCounter over Umami for analytics
|
||||
description: Proposed; GoatCounter gives cookie-free open source analytics in about 30 MB, where Umami needs Postgres and about 300-400 MB.
|
||||
tags: [decision, analytics, resources]
|
||||
status: draft
|
||||
generated: { by: claude-code/claude-opus-5-5, at: 2026-10-11T12:15:30Z }
|
||||
---
|
||||
|
||||
# Proposal
|
||||
|
||||
Self-host GoatCounter in namespace `cv` instead of Umami. Needs Noel's
|
||||
approval as new tooling.
|
||||
|
||||
# Why
|
||||
|
||||
| | Umami | GoatCounter |
|
||||
|---|---|---|
|
||||
| Runtime | Node app | Single Go binary |
|
||||
| Database | Postgres | SQLite file |
|
||||
| Memory | ~300-400 MB with Postgres | ~30 MB |
|
||||
| Cookie-free, no consent banner | Yes | Yes |
|
||||
| Custom events | Yes | Yes |
|
||||
| License | Open source | Open source |
|
||||
|
||||
On a [4 GB shared server](/architecture/server-budget.md), Umami alone would
|
||||
match the whole CV budget.
|
||||
|
||||
# Track
|
||||
|
||||
- Page views.
|
||||
- PDF CV downloads.
|
||||
- Falls per chapter.
|
||||
|
||||
# Details
|
||||
|
||||
One Deployment, 64Mi limit, SQLite on a small `local-path` volume. No backup:
|
||||
losing analytics hurts nobody.
|
||||
@@ -6,6 +6,10 @@
|
||||
* [CI/CD on Gitea Actions](ci-on-gitea.md) - The existing Gitea instance and runner on the home server build, scan, deploy and version the project.
|
||||
* [Knowledge bundle lives at the repository root](bundle-at-root.md) - The repository root is the OKF bundle root; any other markdown file there needs frontmatter to stay conformant.
|
||||
|
||||
# Proposed
|
||||
|
||||
* [GoatCounter over Umami for analytics](goatcounter-over-umami.md) - Proposed; GoatCounter gives cookie-free open source analytics in about 30 MB, where Umami needs Postgres and about 300-400 MB.
|
||||
|
||||
# Open
|
||||
|
||||
* [Open questions](open-questions.md) - Decisions still to make, with the release that needs each answer.
|
||||
@@ -15,5 +15,6 @@ generated: { by: claude-code/claude-opus-5-5, at: 2026-10-11T12:15:30Z }
|
||||
| Which Gitea release-please action, exact name | 0.1.0 | None, Noel names it |
|
||||
| Staging for k6 in CI: namespace or separate cluster | 1.2.0 | Namespace `cv-staging` on the same cluster |
|
||||
| MCP scope: read-only or read plus `/fall` | 1.1.0 | Read plus `/fall`, same limits as visitors |
|
||||
| Approve GoatCounter for analytics | 0.9.0 | None, needs Noel |
|
||||
| Approve PyTorch for the language model | 1.5.0 | None, needs Noel |
|
||||
| Approve NumPy (or similar) for the own autograd engine | 1.13.0 | None, needs Noel |
|
||||
Reference in new issue
Block a user