Deploy repos to your server in one command. No pain. No DevOps.

VPS Ninja is a skill for Claude Code that configures your VPS, installs Dokploy, creates SSL domains, and sets up push-to-deploy automatically.

See Benchmarks

100% pass rate across all benchmarks · v3.1.1 · 20+ supported stacks

claude-vps-ninja

Evolution of Ninja

How we reached a 100% Pass Rate by fixing AI deployment hallucinations.

v1

Initial Release

Basic deploy and DB management. Claude often "googled" Dokploy docs, finding outdated versions and hallucinating endpoints.

v2

The Dokploy v0.27+ Fix

Adapted to breaking changes (environmentId). Improved bash scripts with error handling and hardcore security (UFW + swap).

v3

The Ultimate DevOps AI

Zero-Hallucination Docs, GitHub App Mastery, Let's Encrypt --no-proxy fix, and built-in MCP server. 100% Pass Rate.

  • 6 built-in reference guides
  • Native Dokploy + GitHub App integration
  • Automated --no-proxy Cloudflare toggle
  • Bundled MCP server for fresh docs
v3.1.1

Battle-Tested & Secure

9 production bugs fixed. 4-tier fallback chain, command injection fix, complete Zod schema compliance, --dry-run mode.

  • 4-tier deploy fallback: GitHub App → git → PAT → Docker
  • Security: injection fix, SSHPASS env, quote escaping
  • --dry-run, --server flags, resource warnings
  • All API fields verified against Dokploy Zod schemas

Under the Hood Magic

VPS Ninja handles the infrastructure complexity so you can focus on writing code.

Stack Detection Magic

Auto-detects Next.js, Django, Go, Docker. Finds the right port automatically.

DNS & SSL Autopilot

Automatically creates A-records in Cloudflare (even knows about --no-proxy for Let's Encrypt).

Instant Databases

Need Postgres or Redis? Just type /vps db create postgres app-db. Done.

GitHub App Auto-deploy

No manual webhooks. Push to main — code is in production instantly.

The Proof in the Numbers

Naked Claude Code gives up 76% of the time. VPS Ninja finishes the job every time.

Claude Without Skill

Pass Rate24%
Average Time180.0s
  • Googles outdated API docs
  • Fails Let's Encrypt due to CF Proxy
  • Suggests manual webhook setup

Claude + VPS Ninja

Pass Rate100%
Average Time137.7s
  • Reads built-in references instantly
  • Automates --no-proxy DNS changes
  • Leverages native GitHub App integration
See Detailed Benchmarks

Start Coding, Stop Ops

3 steps to turn Claude into your dedicated DevOps engineer.

01

01.Install Skill

please install skill from https://github.com/kyzdes/vps-ninja

Ask Claude to install the skill — it clones the repo and symlinks it automatically.

02

02.Setup Server

$/vps setup <server-ip> <root-password>

SSH in, install Dokploy, configure firewall, swap, fail2ban. One command.

03

03.Deploy App

$/vps deploy github.com/user/app --domain app.example.com

Detect stack, create project, set env vars, DNS + SSL, deploy. Auto-deploy on push.

Built for Paranoia

We know giving an AI access to your servers is scary. That's why we built VPS Ninja like a fortress.

Zero Credential Leakage

servers.json is strictly gitignored. Passwords and API keys are masked locally. Nothing leaves your machine.

Full Transparency

Destructive commands like /vps destroy require manual confirmation. DNS operations show previews before applying.

Autonomous Execution

7 built-in reference guides mean Claude reads local context, not random web pages. Faster, cheaper, and 100% accurate.