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, version, codename and package manager (apt or dnf)
  2. 02reconDocker already installed? daemon version
  3. 03recondaemon active?
  4. 04reconconflicting packages (distro docker.io, podman-docker, containerd, runc)
  5. 05reconofficial Docker repository already configured?
  6. 06reconexisting routes overlapping Docker default networks (172.17-31.x, 192.168.x) — may cut access
  7. 07reconexisting daemon.json (to preserve)
  8. 08reconfree disk space for /var/lib/docker (>= 10 GB recommended)
  9. 09actAdd the official Docker repositoryverify
  10. 10actInstall Docker Engine + Composeverify
  11. 11actNon-overlapping Docker networks (only if recon found a conflict)verify
  12. 12actEnable the daemonverify
  13. 13actVerify with hello-worldverify
  14. 14actAdd the user to the docker group (only if a user is provided)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. 01Add the official Docker repositoryVerified byapt-get update -qq && apt-cache policy docker-ce | grep -c download.docker.com || dnf repolist 2>/dev/null | grep -ci docker
  2. 02Install Docker Engine + ComposeVerified bydocker --version && docker compose version
  3. 03Non-overlapping Docker networks (only if recon found a conflict)Verified bydockerd --validate --config-file /etc/docker/daemon.json
  4. 04Enable the daemonVerified bysystemctl is-active docker
  5. 05Verify with hello-worldVerified bydocker run --rm hello-world 2>&1 | grep -c 'Hello from Docker'
  6. 06Add the user to the docker group (only if a user is provided)Verified byid -nG ${user} | grep -cw docker

SEC.03

Guardrails

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

Docker already installed and active (even from the distro package) → verify and skip, do not replace it. Never `curl | sh`. Do not overwrite an existing /etc/docker/daemon.json: merge after a backup. If a default Docker network overlaps an existing route, configure address-pools BEFORE the first start, or the server may lose network access. Docker changes iptables (FORWARD policy to DROP) and published ports bypass ufw: say so. The docker group is root-equivalent — remind the user, and that a re-login is needed for the change to apply.

SEC.04

Variables

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

NameMeaning
${user}Add this user to the docker group

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.

recipe — fail2ban_setup150+ in catalogue
security4 steps · low risk · idempotentrun
reconsshd present? ufw active? existing jails?✓
actinstall fail2ban · write default jails✓
actenable service · restart sshd (safe)✓
verifytest ban 60s · jails active · sshd alive✓

search by intent — type “firewall”, get ufw

  • 01Read-only reconnaissance before any change
  • 02Every command signed by your browser, approved by you
  • 03Each step verified before the run moves on, every run kept in the history

SEC.06

Deploy on Servor button

Maintain Docker Engine 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.

Deploy on ServorDark background
Deploy on ServorLight background
[![Deploy on Servor](https://servor.app/badges/deploy-on-servor.svg)](https://servor.app/deploy/install-docker)

SEC.07

Verified recipe

Run this recipe on your server

Connect a server, launch the recipe, and approve each step as Servor executes and verifies it. Free plan, no card required.