Self-Host Next.js with Zero Downtime. No Vercel Markup. No Docker Bloat.
NextDeploy is an open-source, compiled Go engine that deploys Next.js applications to a $4 VPS, AWS, or Cloudflare Workers with atomic POSIX cutovers, Caddy edge proxying, and cumulative static chunk pooling.
Why NextDeploy?
Built specifically to eliminate the three deepest friction points of self-hosting Next.js in production.
Atomic Inode Cutovers
Dual-stage TCP + HTTP health probing with atomic POSIX symlink renames. Bad deploys abort cutovers automatically without dropping active client sockets.
The Chunk 404 Solution
Eliminates the "white screen of death" for active browsing sessions by pooling cumulative JavaScript chunks across releases.
Bare-Metal Speed
Skips heavy Docker daemon RAM overhead. Uses Linux kernel cgroup v2 memory sandboxing and offloads all static bytes directly to NVMe disk via Caddy.
One Engine. Any Cloud.
One single nextdeploy.yml config file. Switch targets anytime with zero code changes.
- Bare-metal Caddy edge reverse proxy with auto Let's Encrypt TLS
- Lean standalone artifact uploaded via SFTP (zero VPS build strain)
- Sandboxed systemd service (ProtectSystem=strict, cgroup v2 limits)
- Dual-stage TCP & HTTP health checks on new port before cutover
- Cumulative shared_static pool (eliminates Chunk 404s for active users)
- Atomic POSIX current symlink swap and zero-downtime caddy reload
nextdeploy prepare && doppler run -- nextdeploy shipversion: "1.0"
target_type: vps
app:
name: my-app # lowercase slug (e.g. "my-saas")
environment: production
domain: app.example.com # your public domain
port: 3000
servers:
- name: production
host: 192.0.2.123 # VPS IP address
user: ubuntu # SSH user
ssh_key: ~/.ssh/id_ed25519
port: 22Live Docs & Reference
Authored directly inside Notion databases. Synchronized seamlessly to the edge with zero build lag.
Draft in Notion
Write architecture RFCs, deployment steps, and guides using native Notion blocks.
Webhook Sync
Changes invalidate edge caches instantly via atomic ISR API routes.
Sub-millisecond Edge
Delivered with syntax highlighting, search index, and zero client hydration penalty.
Production Deployment Blueprints
Complete blueprints for VPS (Bare-Metal + Caddy), Cloudflare Workers (Edge + R2), AWS Serverless, and Doppler secrets.
nextdeploy prepare && doppler run -- nextdeploy shipnextdeploy apply && doppler run -- nextdeploy shipdoppler run -- nextdeploy shipHow NextDeploy Compares
The developer experience of managed cloud platforms without the cloud markup or Docker baggage.
| Capability | NextDeploy | Vercel | Docker / Coolify |
|---|---|---|---|
Zero-Downtime Cutovers POSIX rename avoids killing in-flight client TCP sockets. | Atomic POSIX symlink (0ms) | Edge routing cutover | Restart delay (3-8s gap) |
Chunk 404 Prevention Old JavaScript chunks are preserved so users browsing during a deploy don't get white screens. | Cumulative shared_static/ pool | Retained on CDN blob store | Broken on container rebuild |
Memory Footprint Runs comfortably on $4/mo 1GB RAM droplets with zero thrashing. | ~14MB Go binary + Caddy | N/A (Managed Serverless) | ~850MB Docker Daemon & containerd |
SSL / TLS Edge Certificates Zero configuration HTTPS with automatic HTTP/2 and HTTP/3 support. | Auto Let's Encrypt via Caddy | Automatic | Manual Traefik / Nginx setup |
Hosting Costs Save thousands per year on high-traffic apps with zero artificial seat licenses. | $4 - $6 / mo (Hetzner / VPS) | $20+ / user + bandwidth overages | $12+ / mo (requires >= 2GB RAM) |
Vendor Lock-in Switch between VPS, Cloudflare, and AWS with one line in nextdeploy.yml. | 100% Open Source (Apache 2.0) | Proprietary middleware / ISR logic | Open source |