Skip to content

docs: install script provisions systemd unit and starter config#4

Merged
raffaelschneider merged 1 commit into
mainfrom
docs/install-systemd-bootstrap
May 3, 2026
Merged

docs: install script provisions systemd unit and starter config#4
raffaelschneider merged 1 commit into
mainfrom
docs/install-systemd-bootstrap

Conversation

@raffaelschneider

Copy link
Copy Markdown
Contributor

Summary

Documents the new install flow shipping in zentinelproxy/zentinel#224: curl | sh now drops the unit, sysusers snippet, and starter config at /etc/zentinel/zentinel.kdl on systemd hosts. Service enable and start are opt-in via --enable-service.

Changes

  • getting-started/installation.md: updated the install-script section to cover the new flags (--enable-service, --skip-service), the file layout, and the manual fallback for source builds.
  • deployment/systemd.md: added a "Quick install" section at the top pointing at the script. Manual setup walkthrough kept for source builds, air-gapped hosts, and agent-alongside-proxy deployments. Fixed a stale install URL (zentinelproxy.io/install.shget.zentinelproxy.io).

Linked

Test plan

  • Build the site locally (zola serve); pages render without broken links
  • Verify the [systemd Deployment](/docs/deployment/systemd/) cross-link from the installation page resolves
  • After zentinel#224 merges, verify a fresh curl | sh matches the documented behavior

The install script (curl | sh) now drops a managed-service layout on
systemd hosts: unit, sysusers snippet, starter config at
/etc/zentinel/zentinel.kdl. Service enable and start are opt-in via
--enable-service.

Updates:
- getting-started/installation.md: documents the new flow, the
  --enable-service / --skip-service flags, file layout, and the
  manual fallback for source builds.
- deployment/systemd.md: adds a "Quick install" section pointing at
  the script. The manual setup walkthrough remains for source-build
  and air-gapped use cases. Fixes a stale install URL.

Tracks zentinelproxy/zentinel#223.
@cloudflare-workers-and-pages

Copy link
Copy Markdown

Deploying zentinelproxy-io-docs with  Cloudflare Pages  Cloudflare Pages

Latest commit: c7441ed
Status: ✅  Deploy successful!
Preview URL: https://abf3d940.zentinelproxy-io-docs.pages.dev
Branch Preview URL: https://docs-install-systemd-bootstr.zentinelproxy-io-docs.pages.dev

View logs

@raffaelschneider raffaelschneider merged commit eb5b8ef into main May 3, 2026
3 checks passed
@raffaelschneider raffaelschneider deleted the docs/install-systemd-bootstrap branch May 3, 2026 07:37
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