← Back to site Loading…

rescriptum

Running it

Guide

Generated on August 30, 2026

Running it

Running it

rescriptum is one process, configured entirely through the environment, that writes nothing outside the store you point it at. Running it well is mostly about deciding what it is allowed to serve and to whom.

  • Deployment — a systemd unit, a container, or nothing at all.
  • Synology DSM 7 — the original target: a Package Center install that creates the share, registers the port and starts at boot.
  • Security — the two tokens, why they behave differently, and what neither of them protects.
  • Capturing requests — record what machines actually send, and replay it offline.
  • The SQLite store — for a fleet administered by tooling rather than by hand.
  • The admin API — manage answers over HTTP, on its own listener, with a write that cannot break the fleet.
  • Troubleshooting — the log line is the whole diagnostic
  • Serving boot media — the installer’s own kernel, initrd and image, from the same server.
  • Netbooting a machine — TFTP, the loader, the menu, and their DHCP server’s two lines. story.

The shape of a deployment

One processno supervisor tree, no workers to size, no sidecar
One port by defaultplus a second, only if you enable the admin API
No writesoutside the answers directory or database, and none at all unless you enable the admin API or request capture
No statebetween requests. Restarting loses nothing
Graceful shutdownon SIGTERM (what DSM’s scheduler sends) and Ctrl-C

Configuration is environment variables only. A zero or unparseable numeric value falls back to its default rather than starting a server that accepts connections and never answers.

What it needs from the network

The installer has to reach it, and that is all. It makes no outbound connections, needs no DNS, and does not care whether it is behind NAT.

Plain HTTP is the normal choice on a provisioning network. If you need TLS — some installer versions ask for a certificate fingerprint — terminate it in front with nginx or Caddy and point the ISO at that. See Security.