Skip to content

docs(deploy): add a systemd unit and a guide for running without Docker - #108

Merged
A-EDev merged 1 commit into
mainfrom
docs/systemd-bare-metal
Nov 15, 2026
Merged

A-EDev merged 1 commit into
mainfrom
docs/systemd-bare-metal

Conversation

@A-EDev

@A-EDev A-EDev commented Nov 14, 2026

Copy link
Copy Markdown
Contributor

Summary

  • deploy/systemd/flow-sync.service: runs the bundled node.cjs as a hardened systemd service with a temporary user (DynamicUser), its data in StateDirectory, the admin token from LoadCredential, and a system call filter that fails disallowed calls with EPERM.
  • IPAddressAllow=localhost with IPAddressDeny=any, so only a proxy on the same host reaches the server, which keeps FLOW_SYNC_TRUST_PROXY=1 safe.
  • docs/bare-metal.md: install from a release tag, Caddy for HTTPS, settings, and updates. Listed in docs/README.md.
  • CHANGELOG line under Server.

Related issue

Related to Flow-Tube/Flow#1075 (a request for a systemd service like Jellyfin's) and Flow-Tube/Flow#1249.

Change type

  • Bug fix
  • Feature
  • Refactor or maintenance
  • Documentation or specification
  • Build, packaging, or CI

Validation

  • pnpm check: Checked 154 files, no fixes applied
  • pnpm typecheck: not applicable, no code changes
  • pnpm test: not applicable, no code changes
  • The guide's build steps: pnpm --filter @flow-sync/server build, then node node.cjs from a copy of dist/ with no node_modules; GET /v1/health returned 200 and the bundled health check exited 0 (macOS, Node 24.21.0).

Risk and compatibility

  • New deployment option only; the Docker image and other hosts are unchanged.

  • The unit has not been started under systemd yet; the guide's "Not verified" section says so.

  • Spec, reference implementation and vectors agree (protocol changes only).

  • No content, keys, tokens or IP addresses are logged.

  • Dependency and lockfile changes are intentional and limited to this PR.

@A-EDev
A-EDev merged commit 99db05a into main Nov 15, 2026
10 checks passed
@A-EDev
A-EDev deleted the docs/systemd-bare-metal branch November 15, 2026 10:14
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