Skip to content

Warn in the Baseline that a non-default origin needs a rebuild - #31

Merged
chip-peanut-bot[bot] merged 1 commit into
mainfrom
docs/selfhost-baseline-origin
Sep 2, 2026
Merged

Warn in the Baseline that a non-default origin needs a rebuild#31
chip-peanut-bot[bot] merged 1 commit into
mainfrom
docs/selfhost-baseline-origin

Conversation

@chip-peanut-bot

Copy link
Copy Markdown
Contributor

Task 4 of the Show-HN handoff (report + doc-PR lane only).

Smoke result — the publication-gate item PASSES with one doc gap. Fresh anonymous clone of the now-public repo → cp .env.example .envdocker compose up --build (host ports overridden 3000→24361 / 5433→24362 via a compose override because this box occupies both): image builds, migrations apply, db+app go healthy (~the app's own HEALTHCHECK reports healthy), /healthcheck answers, and POST /api/rooms creates a room (201, full room+member+token) when the request host matches the built origin.

The gap: the baked NEXT_PUBLIC_BASE_URL default (http://localhost:3000) canonical-redirects every request — API included — arriving on any other host:port. A self-hoster who edits the compose ports (or fronts it with a hostname) gets an instance that 308s everything to a dead URL with no hint. The Configuration section documents the build arg; the Baseline section now points at the trap. One paragraph, docs-only.

Teardown verified: containers, volumes, local images, clone dir all removed.

Clean-machine smoke (2026-09-02, publication-gate item): a fresh public clone
builds and serves a working instance first try — migrations apply, both
containers go healthy, and POST /api/rooms returns 201 — but only at the
origin baked at build time. Published on any other port, the canonical-origin
redirect 308s every request, API included, to the dead default, and the
Baseline section gave no hint why. The Configuration section already explains
the build argument; this links the trap to the steps that spring it.

Ordered-By: Hugo0
Order: https://github.com/peanutprotocol/peanutsplit/blob/main/ops/steward/HANDOFF-2026-09-02-showhn.md
@chip-peanut-bot
chip-peanut-bot Bot merged commit bc82f7a into main Sep 2, 2026
6 checks passed
@chip-peanut-bot
chip-peanut-bot Bot deleted the docs/selfhost-baseline-origin branch September 2, 2026 10:40
Hugo0 added a commit that referenced this pull request Sep 2, 2026
Readers arriving from a link saw licensing prose first and a paragraph about
an unused Fastify app; the product, the try-it link and the self-host
command were below the fold. Put those on top, with the site's card as the
hero image, and say who pays for it in one line.

The contributing and stewardship wording kept the policy (maintainer-led,
issue before feature PR) but read as hostile; soften the tone, not the
rule. STEWARDSHIP still said the repo was not public; it has been since
1 September. SELF-HOSTING still listed the clean-machine smoke test as an
open gate; it passed today (PR #31).

Claude-Session: https://claude.ai/code/session_01NKWpwUpsVvQzSMcDrqvmrE
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants