Configuration Guide

Complete reference for nextdeploy.yml configuration.

Core Target Configuration

version: 1.0
target_type: "vps" # Choose "vps" or "serverless"
app:
  name: my-app
  environment: production
  domain: app.example.com

Field	Type	Required	Description
`name`	string	✓	Unique identifier for your app
`environment`	string	✓	Deployment environment
`domain`	string	⚠️	Required for HTTPS setup
`port`	number	✓	Port your Next.js app listens on

target_type: "serverless"
serverless:
  provider: "aws"
  region: "us-east-1"
  s3_bucket: "my-nextjs-assets"

AWS_ACCESS_KEY_ID=your-key
AWS_SECRET_ACCESS_KEY=your-secret

target_type: "vps"
servers:
  - host: 192.168.1.100         # VPS IP address
    ssh_key: "~/.ssh/id_rsa"    # Path to local SSH Config Key

deployment:
  keep_releases: 5     # Number of old deployments to keep on disk for rollbacks

Create multiple config files:

nextdeploy.yml           # Default (development)
nextdeploy.staging.yml   # Staging
nextdeploy.prod.yml      # Production

Use with:

nextdeploy build --config nextdeploy.prod.yml

Validate your configuration:

nextdeploy validate