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. 01reconZFS already present (tools + module) + version
  2. 02recondo the disks exist? consistent sizes?
  3. 03reconsignature on a disk = data → NEVER overwrite
  4. 04reconsystem disk to exclude; does a pool with the same name already exist?
  5. 05reconstable by-id paths of the disks (to use for the pool)
  6. 06recondistro and kernel; Secure Boot active (unsigned DKMS module → blocking)
  7. 07reconRAM: 2 GB minimum recommended for ZFS
  8. 08actPrepare the ZFS repository (Debian and RHEL only)verify
  9. 09actInstall ZFSverify
  10. 10actLoad the moduleverify
  11. 11actSimulate the pool creationverify
  12. 12actCreate the ${pool_name} pooldestructiveverify
  13. 13actCheck the mountverify

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. 01Prepare the ZFS repository (Debian and RHEL only)Verified byrpm -q zfs-release 2>/dev/null || apt-cache policy zfsutils-linux | head -3
  2. 02Install ZFSVerified bycommand -v zpool
  3. 03Load the moduleVerified bylsmod | grep -c '^zfs '
  4. 04Simulate the pool creationVerified byzpool list -H -o name ${pool_name} 2>/dev/null || echo absent
  5. 05Create the ${pool_name} poolVerified byzpool status -x ${pool_name}
  6. 06Check the mountVerified byzfs get -H -o value mounted ${pool_name}

SEC.03

Guardrails

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

REFUSE to create a pool on disks carrying a signature or on the system disk. Never zpool create -f. Prefer /dev/disk/by-id paths. Ask for explicit confirmation before any zpool create. Secure Boot blocking → stop, do not disable it.

SEC.04

Variables

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

NameMeaning
${pool_name}Pool name
${devices}Disks
${raid}RAID

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 ZFS pool 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/setup-zfs-pool)

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.