server-prep v1.1.1
Debian & Ubuntu · VPS or dedicated · Coolify, Dokploy, Openship

From a fresh server to a panel-ready one, with proof.

server-prep locks down a new server (SSH keys on a new port, a firewall that also covers Docker, intrusion blocking, automatic security updates) and gets it ready for your deployment panel. An audit runs before and after, so you see what changed.

Build your setup

Pick your server and panel. See exactly what you get.

The dashboard, the firewall faceplate, the logins, the commands and the config file all follow your choices.

Your setup

Machine
Deployment panel
How the panel reaches the server

Apps on ports 80 and 443

Office or home public IPs, or a LAN range. Find yours with curl -4 ifconfig.me on your own computer. Leave it empty only if your computer is on the same Tailscale network.

a-z, 0-9 and hyphens.

Empty = the user who runs sudo.

Optional steps (auditd, AIDE, Telegraf, Telegram...) are switched on and off in the step list.

Your server after server-prep

Firewall after server-prep · incoming ufw · default deny
admin@web-01Commands, in order

    If SSH locks you out: log in from the console. sudo ufw disable opens the firewall again. sudo bash /var/lib/server-prep/backups/<date>/rollback.sh restores every file server-prep changed. The 10-minute auto-undo only covers the SSH settings, not the firewall.

    Your config file

    Save it next to the scripts. It never holds secrets: tokens are typed at the prompt. Filled configs are ignored by git.

    web-01.conf
    
        
    What runs, in order

    Two scripts, every step listed.

    Each step can run twice safely, backs up the files it changes, and goes in the report. Use --only or --skip with these names. Switch optional steps here and the config above follows.

    First boot server-preconfig.sh

    Security server-prep.sh

    What the audit checks

    server-audit.sh, read-only.

    Checks per area

    Each check counted once, by the worst result it can give

    Hover or focus a bar for its count.
    VPS or dedicated server

    Same scripts. A few details change.

    With an AI agent

    Let Claude Code walk you through it.

    The repo ships project context and skills, so an agent can guide you question by question. You stay in control: you run every sudo command and type every secret yourself.

    Works today

    Claude Code + /new-server

    • /new-server: guided setup, from first SSH to the final audit.
    • /audit-review: paste an audit, get a fix for every WARN and FAIL.
    • /monitoring: Telegraf, InfluxDB and Grafana.
    • /add-step: the checklist for changing the scripts.
    • Codex finds the same skills: type $new-server, or pick one from /skills.
    Planned

    For beginners

    • A beginner mode that asks plain questions and stops before risky steps.
    • JSON output from every script, so the agent reads facts.
    • Openship support at the same level as Coolify.

    Follow the roadmap on GitHub · the beginner epic

    Guides and help

    Go further.