Deployment

Before deploying, run:

pnpm build

Fix build errors before shipping.

Do not deploy with placeholder billing URLs, test API keys, or old metadata images. Buyers will see those in production.

Environment Variables

Add the same production values to your hosting provider that you use locally. Common variables:

PTERODACTYL_PANEL_URL=https://panel.example.com
PTERODACTYL_APP_KEY=ptla_xxxxxxxxxxxxxxxxx
UPTIMEROBOT_API_KEY=ur_xxxxxxxxxxxxxxxxx
NEXT_PUBLIC_DISCORD_GUILD_ID=000000000000000000

Only expose variables with NEXT_PUBLIC_ when the browser needs them.

Vercel

Recommended for most users.

Push the project to GitHub, GitLab, or Bitbucket.
Import the project in Vercel.
Confirm framework is Next.js.
Add environment variables.
Deploy.

Vercel settings:

Framework Preset: Next.js
Install Command: pnpm install
Build Command: pnpm build
Output Directory: .next

Railway

Create a new Railway project.
Deploy from GitHub.
Add environment variables.
Generate or connect a domain.

Render

Use:

Build Command: pnpm install && pnpm build
Start Command: pnpm start

Add environment variables in Render dashboard.

VPS

Install dependencies:

pnpm install

Build:

pnpm build

Start:

pnpm start

For production VPS deployments, use PM2 and Nginx. Example:

pm2 start pnpm --name sonata -- start
pm2 save

Example Nginx reverse proxy:

server {
  server_name example.com;

  location / {
    proxy_pass http://127.0.0.1:3000;
    proxy_http_version 1.1;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
  }
}

Use your own SSL setup, such as Certbot or your hosting provider’s certificate manager.

Post-Deploy Tests

After deployment, open production pages directly:

/
/game-host
/web-host
/app-host
/vps
/domain
/nodes
/status

Then test:

Checkout links.
Domain lookup.
Status API.
Game stock API.
Discord widget.
Metadata preview.
Mobile layout.

Production Checklist

Environment variables are set.
Billing URLs are production URLs.
Brand assets are replaced.
SEO metadata is updated.
Product data is accurate.
Light and dark mode are readable.
Domain lookup works.
Status page works.
Game stock works if enabled.
License file is included.
Build succeeds.

About Zaqua

LucentUI

Sonata

Deployment

Deployment

Environment Variables

Vercel

Railway

Render

VPS

Post-Deploy Tests

Production Checklist

​Deployment

​Environment Variables

​Vercel

​Railway

​Render

​VPS

​Post-Deploy Tests

​Production Checklist

Deployment

Environment Variables

Vercel

Railway

Render

VPS

Post-Deploy Tests

Production Checklist