
levels.io VPS Setup Skill
github.com/avanderheyde/levelsio-vps-setup-skill- Category
- AI Agents
- Rank
- No. 1848Tools index
- Pricing
- Open Source
- Type
- AGENT
- Builder
- @Alderik_
- GitHub
- 43 stars
- Date
About
A Claude Code agent skill that provisions and operates a web app on one hardened Ubuntu VPS instead of a multi-service PaaS, wiring up Node.js, SQLite, Caddy for TLS, systemd and backups on a single box. It supports deploying from a local machine or developing directly on the server with Claude Code held open in a tmux session, reachable over Tailscale. Optional steps cover Cloudflare domain setup and Stripe subscription billing.
What it does
An opinionated operations playbook for small Node applications. It guides Claude through two modes: build remotely from a local checkout, or edit production directly through a persistent terminal session. The stack combines SQLite, Caddy, systemd, private SSH access, offsite replication, optional edge routing, and subscription billing.
Why it's ranked here
The repository turns a coherent single-server philosophy into editable scripts and unusually detailed operational guidance. It handles native SQLite builds, secret placement, service recovery, SSH lockout prevention, domains, and payments. The verdict is mixed-positive because its narrow assumptions create clarity, while direct production development and broad passwordless sudo demand experienced judgment.
What's good
The deployment builds native dependencies on the server, keeps database files outside the replaced application tree, and verifies service health after restart. Provisioning refuses to disable password login without an authorized key. The private-network lockdown requires explicit confirmation before removing public SSH access. Troubleshooting covers database contention, missing native bindings, certificate failures, permissions, restart loops, and recovery from lockout.
Tradeoffs
This is a template collection, not a turnkey platform. Users must inspect and edit configuration before execution. It centers Ubuntu, Node, Next.js, SQLite, Caddy, systemd, Tailscale, and specific cloud workflows. The production-editing path removes a normal development boundary. Provisioning grants the deploy user unrestricted passwordless sudo. Single-box operation also concentrates application and database availability, making tested offsite restoration essential.
How to use it well
Use it for a solo or small-team Node product whose traffic and data fit one vertically scaled server. Choose remote deployment when staging boundaries matter. Choose on-server development only with disciplined version control and working backups. It earns a place as a concrete self-hosting runbook, but it does not cover clustered availability, distributed databases, container orchestration, or general multi-service architecture.
Technical notes+
SKILL.md routes users between host-only and on-VPS workflows. scripts/provision.sh targets Ubuntu 24.04, creates a non-root service account, writes Caddy and systemd configuration, stores environment values under /etc/<app>/env, and grants unrestricted passwordless sudo. scripts/deploy.sh uses rsync, performs npm ci and the build remotely, copies the better-sqlite3 native binding, swaps standalone output, restarts systemd, and checks HTTPS. One caveat: its health-check domain is derived from SSH_HOST, so a tailnet IP or non-public SSH hostname may not match the configured public domain. scripts/lock-down-tailscale.sh includes connection checks and interactive confirmation. scripts/setup-stripe.sh protects the key through a mode-restricted file, but parses Stripe CLI JSON with grep and cut, which is brittle compared with structured parsing. references/troubleshooting.md documents concrete recovery paths.
Observed
- License
- MIT License
- Primary implementation
- Bash script templates with Markdown operational documentation
- Install surface
- Copied into a Claude Code project-level or user-level skills directory for automatic discovery
- Interface
- Claude Code Agent Skill supported by editable command-line scripts
- Server platform
- Fresh Ubuntu 24.04 LTS VPS, with Hetzner and DigitalOcean workflows documented
- Application scope
- Next.js standalone or another Node application using a single self-contained process
- Repository structure
- Skill definition, shell scripts, reference guides, README, and license; no test directory appears in the provided tree
Read from README.md, LICENSE, SKILL.md, scripts/deploy.sh, scripts/provision.sh, scripts/setup-stripe.sh, references/architecture.md, scripts/setup-dev-on-vps.sh, references/develop-on-vps.md, references/monetize-stripe.md, references/troubleshooting.md, scripts/lock-down-tailscale.sh, references/domain-cloudflare.md, references/provision-hetzner.md.
Tags
Comments (0)
No comments yet
Editorially curated, with community endorsements as a secondary signal. Corrections welcome.