SEC.01

The playbook

The run starts read-only: the recon probes decide what happens next. The steps that follow are adapted to the distribution and state found — a real machine is rarely clean.

1. 01recondistro and version: apt (Debian/Ubuntu) or dnf (RHEL/Fedora/Rocky/Alma)?
2. 02reconDocker Engine + compose plugin present and service active? (podman-docker or snap Docker: report it, do not mix)
3. 03reconpaperless already deployed (container, volumes, /opt/paperless)? healthy → verify and skip; never overwrite or delete
4. 04reconport 8000 (or the one from the port variable) already taken, and by what? empty = free; taken → ask for another port (ask_user)
5. 05reconfree RAM, CPU and disk: ≥ 2 GB of RAM recommended (OCR)
6. 06recononly if a domain is provided: is a reverse proxy already on 80/443? (reuse it rather than installing a second one)
7. 07reconis a firewall (ufw or firewalld) active?
8. 08actInstall Docker Engine + Compose (only if missing)verify
9. 09actGenerate the secrets (.env + docker-compose.env)verify
10. 10actWrite /opt/paperless/docker-compose.ymlverify
11. 11actDeclare the public URL (only if a domain is provided)verify
12. 12actStart the stackverify
13. 13actResponds over HTTPverify
14. 14actInstall Caddy (only if a domain is provided and no reverse proxy)verify
15. 15actHTTPS reverse proxy (only if a domain is provided)verify
16. 16actOpen 80/443 (only if a domain is provided and a firewall is active)verify

SEC.02

What it verifies

Each step ships its own check. The run only moves on when the check passes, so what the recipe reports as done is what is actually on the server.

1. 01verifyInstall Docker Engine + Compose (only if missing)Verified bydocker compose version && systemctl is-active docker
2. 02verifyGenerate the secrets (.env + docker-compose.env)Verified bygrep -c "^PAPERLESS_SECRET_KEY=" /opt/paperless/docker-compose.env && stat -c %a /opt/paperless/.env
3. 03verifyWrite /opt/paperless/docker-compose.ymlVerified bycd /opt/paperless && docker compose config --quiet && echo ok
4. 04verifyDeclare the public URL (only if a domain is provided)Verified bygrep -c "^PAPERLESS_URL=https://" /opt/paperless/docker-compose.env
5. 05verifyStart the stackVerified bydocker inspect -f '{{.State.Status}}' paperless
6. 06verifyResponds over HTTPVerified bycurl -s -o /dev/null -w '%{http_code}' --retry 40 --retry-delay 5 --retry-connrefused http://127.0.0.1:${port}/
7. 07verifyInstall Caddy (only if a domain is provided and no reverse proxy)Verified bycaddy version && systemctl is-active caddy
8. 08verifyHTTPS reverse proxy (only if a domain is provided)Verified bycurl -s -o /dev/null -w '%{http_code}' --retry 6 --retry-delay 5 https://${domain}/
9. 09verifyOpen 80/443 (only if a domain is provided and a firewall is active)Verified byufw status 2>/dev/null | grep ALLOW; firewall-cmd --list-ports 2>/dev/null; true

SEC.03

Guardrails

Non-negotiable instructions the run must respect, whatever it finds on the server.

SEC.04

Variables

What you choose before launching — the recipe fills in the rest.

SEC.05

How a recipe runs in Servor

Servor is zero-knowledge: the platform cannot execute anything on its own. When you launch this recipe, a run reads the reconnaissance, plans the steps and asks for your approval. Each approved command is signed by your browser — with a key the server never sees — then relayed verbatim to the agent, which verifies the signature locally before executing.

SEC.06

Deploy on Servor button

Maintain Paperless-ngx or a project that needs it? Put this button in your README or on your site: one click and your users install it on their own server.

SEC.07

More self-hosted recipes

1. 01VaultwardenVaultwarden password manager (Bitwarden-compatible) via Docker Compose, over HTTPS when a domain is provided.
2. 02GiteaLightweight Gitea Git forge via Docker Compose (SQLite), web on localhost, Git SSH on a dedicated port.
3. 03Uptime KumaUptime Kuma 2 uptime monitoring via Docker Compose, over HTTPS when a domain is provided.
4. 04NextcloudNextcloud (file cloud) via Docker Compose: PostgreSQL, Redis, cron, admin created automatically.
5. 05JellyfinJellyfin media server via Docker Compose, media folder mounted read-only, HTTPS when a domain is provided.