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 and package manager (apt or dnf)
  2. 02reconJava already present? which major (compared with the one the MC version requires)?
  3. 03recondoes the dedicated minecraft user already exist?
  4. 04recondoes a server already exist (server.jar, world/, server.properties, active service)? never overwrite a world
  5. 05reconis the server port free?
  6. 06reconavailable RAM ≥ requested RAM + 512 MB for the system? free disk ≥ 2 GB
  7. 07reconactive firewall (ufw or firewalld)? a port is only opened if one is active
  8. 08actInstall curl and jqverify
  9. 09actFind the required Java versionverify
  10. 10actInstall Java (headless JRE of the required major)verify
  11. 11actCreate the dedicated minecraft user and /opt/minecraftverify
  12. 12actDownload the server (${flavor} ${mc_version})verify
  13. 13actAccept the Minecraft EULAverify
  14. 14actConfigure server.properties (port, players, difficulty)verify
  15. 15actminecraft systemd service + startupverify
  16. 16actOpen ${port}/tcp (only if a firewall is active)verify
  17. 17actThe server is listeningverify

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. 01Install curl and jqVerified byjq --version
  2. 02Find the required Java versionVerified bytrue
  3. 03Install Java (headless JRE of the required major)Verified byjava -version 2>&1 | head -1
  4. 04Create the dedicated minecraft user and /opt/minecraftVerified byid -u minecraft && stat -c '%U' /opt/minecraft
  5. 05Download the server (${flavor} ${mc_version})Verified bytest -s /opt/minecraft/server.jar -o -x /opt/minecraft/run.sh && echo ok
  6. 06Accept the Minecraft EULAVerified bygrep -c eula=true /opt/minecraft/eula.txt
  7. 07Configure server.properties (port, players, difficulty)Verified bygrep -E '^(server-port|max-players|difficulty)=' /opt/minecraft/server.properties
  8. 08minecraft systemd service + startupVerified bysystemctl is-enabled minecraft && systemctl is-active minecraft
  9. 09Open ${port}/tcp (only if a firewall is active)Verified byufw status 2>/dev/null | grep -cE '${port}'; firewall-cmd --list-ports 2>/dev/null; true
  10. 10The server is listeningVerified bytimeout 270 bash -c 'until ss -tlnH "sport = :${port}" | grep -q LISTEN; do sleep 5; done' && echo listening

SEC.03

Guardrails

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

The server runs as the minecraft user, never root. Java = the major the version requires (Mojang manifest), not another one. An existing world in /opt/minecraft is never overwritten: reuse it. The requested RAM must leave ≥ 512 MB to the system, otherwise lower it and say so. Only open the game port, and only if a firewall is active.

SEC.04

Variables

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

NameMeaning
${mc_version}Minecraft version
${flavor}Server type
${max_players}Max players
${ram_mb}RAM (MB)
${port}Port
${difficulty}Difficulty

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 Minecraft Server (Java) 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-minecraft-java)

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.