Skip to content

feat+docs: Windows feedzero.ps1 auto-TLS parity + simplify self-host docs#220

Merged
forcingfx merged 4 commits into
mainfrom
feat/selfhost-simplify
May 31, 2026
Merged

feat+docs: Windows feedzero.ps1 auto-TLS parity + simplify self-host docs#220
forcingfx merged 4 commits into
mainfrom
feat/selfhost-simplify

Conversation

@forcingfx

Copy link
Copy Markdown
Owner

Two self-host follow-ups.

1. feedzero.ps1 auto-TLS parity (#212)

Brings the Windows PowerShell CLI to parity with the bash one (which #217 already fixed): classifies HOSTNAME, auto-selects Caddyfile.lan for IP/localhost/.local (exports CADDYFILE), adds the config dry-run command, and brings doctor up to date (hostname class, Caddyfile-as-directory trap, image/Portainer note). Mirrors scripts/feedzero-lib.sh exactly.

⚠️ Not run-verified — no PowerShell in CI here. Logic mirrors the bash path I did verify end-to-end on real Docker; reviewed for PowerShell correctness (regex classifiers, switch, $env:CADDYFILE, Test-Path -PathType).

2. Simplify the self-host docs

  • docs/self-hosting.md: 509 → 96 lines. Kept the 3-step deploy, the LAN/trust-root-CA steps, terse day-2 + troubleshooting, and the Portainer gotcha. Cut VPS-shopping advice, the DuckDNS walkthrough, per-OS Docker-install prose, and long rationale (→ ADR 014 link).
  • README.md: 209 → 157 lines. Self-Hosting section is now a 3-step block + a pointer to the guide; moved the VITE_SELF_HOSTED/trade-offs/Vercel detail into the guide/ADR.

No content that other docs link to was removed (verified anchors). No tests touch these files.

Not auto-merging.

🤖 Generated with Claude Code

Mirror scripts/feedzero-lib.sh into PowerShell: classify HOSTNAME, auto-select
Caddyfile.lan for IP/localhost/.local (exporting CADDYFILE), add the config
dry-run command, and bring doctor to parity (hostname class, Caddyfile-as-
directory trap, image/Portainer note). Not run-verified (no pwsh in CI); logic
mirrors the verified bash path.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@vercel

vercel Bot commented May 31, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
feedzero Ready Ready Preview, Comment May 31, 2026 7:38pm

…path

Cut the self-hosting guide 509->96 lines and the README self-host section to
a 3-step block. Keep the deploy steps, LAN/trust-CA path, terse day-2 +
troubleshooting; drop VPS-shopping/DuckDNS/Docker-install walkthroughs and
long rationale prose (linked to ADR 014 instead). No content other docs link
to was removed.
@forcingfx

Copy link
Copy Markdown
Owner Author

README restructured per feedback

Beyond trimming the self-host section, the README now leads with what it is → how to use it:

  • New top "Use it" section: hosted (my.feedzero.app), a one-command docker run … ghcr.io/forcingfx/feedzero:latest (with the GitHub Packages link), and a pointer to the server guide.
  • Removed the confusing npm "Quick Start" (that was dev setup) → folded npm install/npm run dev into Development.
  • Folded the standalone Self-Hosting section into "Use it"; fixed a stale anchor link in docs/marketing/.

README 209 → 143 lines; self-hosting guide 509 → 96.

Note: the :latest one-liner works once you cut the v0.11.0 tag (publishes latest); the public image already pulls anonymously.

…er command)

- Add a top 'Use it' section: hosted link, a one-command docker run from the
  public GHCR image (+ package page link), and a pointer to the server guide.
- Remove the confusing npm 'Quick Start' (that's dev setup) -> moved npm
  install/dev into Development.
- Fold the standalone Self-Hosting section into 'Use it'.
- Fix the tt-rss-migration link that pointed at the removed README anchor.
@forcingfx forcingfx enabled auto-merge (squash) May 31, 2026 19:37
@forcingfx forcingfx merged commit c3ef894 into main May 31, 2026
14 checks passed
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.

1 participant