🚀 VPS Project Specifications
46 Coding Agent-Ready Specs for Your Tiny VPS (1 CPU / 1 GB RAM / 20 GB Disk)
Complete Self-Hosting Guide
📋 What's Inside
Each part contains detailed specifications that a coding agent can use to build and deploy services end-to-end. Every spec includes architecture diagrams, Docker Compose configs, security hardening, backup strategies, and integration points.
13 Projects — WireGuard, Pi-hole, Vaultwarden, ntfy, Tor, and more
Your personal fortress. VPN, DNS-level ad blocking, password management, encrypted notifications, and privacy tools that keep your data yours.
~5-80 MB each
Docker
Must-Haves
15 Projects — Gitea, Caddy, n8n, Uptime Kuma, CI/CD, and more
Your development powerhouse. Git hosting, reverse proxies, workflow automation, monitoring, and the tools that make a $5 VPS feel like a $200 cloud setup.
~5-150 MB each
Docker
Automation
18 Projects — Jellyfin, Navidrome, Matrix, Minecraft, code-server, and more
The fun stuff. Media servers, chat platforms, game servers, dashboards, wikis, and the projects that make your VPS genuinely yours.
~2-700 MB each
Docker
Creative
💡 How to Use These Specs
Each spec is self-contained. Feed it to a coding agent (Claude, GPT, Codex) and it should be able to generate all config files, Docker Compose setups, and deployment scripts. Start with Caddy (Part 2) as your reverse proxy foundation.