Other Platforms

Deploy next-dynenv anywhere—Railway, Fly.io, Render, AWS, GCP, Azure, and beyond.

Railway

Setup

# railway.toml
[build]
builder = "nixpacks"

[deploy]
startCommand = "node server.js"

Environment Variables

Set in Railway dashboard or CLI:

railway variables set NEXT_PUBLIC_API_URL=https://api.example.com
railway variables set NEXT_PUBLIC_APP_NAME=MyApp

Dockerfile Deployment

# Use the Docker deployment guide
railway up --dockerfile

Fly.io

fly.toml

# fly.toml
app = "my-nextjs-app"
primary_region = "iad"

[build]
  dockerfile = "Dockerfile"

[http_service]
  internal_port = 3000
  force_https = true
  auto_stop_machines = true
  auto_start_machines = true
  min_machines_running = 0

[env]
  NODE_ENV = "production"
  PORT = "3000"

Setting Secrets

# Set environment variables
fly secrets set NEXT_PUBLIC_API_URL=https://api.example.com
fly secrets set NEXT_PUBLIC_APP_NAME=MyApp
fly secrets set DATABASE_URL=postgres://...

Deploy

fly deploy

Render

render.yaml

# render.yaml
services:
    - type: web
      name: my-nextjs-app
      env: node
      buildCommand: pnpm install && pnpm build
      startCommand: node .next/standalone/server.js
      envVars:
          - key: NEXT_PUBLIC_API_URL
            value: https://api.example.com
          - key: NEXT_PUBLIC_APP_NAME
            value: MyApp
          - key: DATABASE_URL
            fromDatabase:
                name: mydb
                property: connectionString

Environment Groups

Use environment groups for shared variables:

envVars:
    - fromGroup: production-env

AWS (ECS/Fargate)

Task Definition

{
    "containerDefinitions": [
        {
            "name": "nextjs-app",
            "image": "your-registry/my-nextjs-app:latest",
            "portMappings": [
                {
                    "containerPort": 3000,
                    "protocol": "tcp"
                }
            ],
            "environment": [
                {
                    "name": "NEXT_PUBLIC_API_URL",
                    "value": "https://api.example.com"
                },
                {
                    "name": "NEXT_PUBLIC_APP_NAME",
                    "value": "MyApp"
                }
            ],
            "secrets": [
                {
                    "name": "DATABASE_URL",
                    "valueFrom": "arn:aws:secretsmanager:us-east-1:123456789:secret:db-url"
                }
            ]
        }
    ]
}

Google Cloud Run

Deploy Command

gcloud run deploy my-nextjs-app \
  --image gcr.io/my-project/my-nextjs-app \
  --set-env-vars NEXT_PUBLIC_API_URL=https://api.example.com \
  --set-env-vars NEXT_PUBLIC_APP_NAME=MyApp \
  --platform managed \
  --region us-central1

Using Secret Manager

gcloud run deploy my-nextjs-app \
  --image gcr.io/my-project/my-nextjs-app \
  --set-secrets DATABASE_URL=db-url:latest \
  --platform managed

Azure Container Apps

Deployment

# azure-container-app.yaml
properties:
    configuration:
        ingress:
            external: true
            targetPort: 3000
    template:
        containers:
            - name: nextjs-app
              image: myregistry.azurecr.io/my-nextjs-app:latest
              env:
                  - name: NEXT_PUBLIC_API_URL
                    value: https://api.example.com
                  - name: NEXT_PUBLIC_APP_NAME
                    value: MyApp
                  - name: DATABASE_URL
                    secretRef: db-url

DigitalOcean App Platform

app.yaml

# .do/app.yaml
name: my-nextjs-app
services:
    - name: web
      dockerfile_path: Dockerfile
      http_port: 3000
      instance_count: 1
      instance_size_slug: basic-xxs
      envs:
          - key: NEXT_PUBLIC_API_URL
            value: https://api.example.com
          - key: NEXT_PUBLIC_APP_NAME
            value: MyApp
          - key: DATABASE_URL
            scope: RUN_TIME
            type: SECRET

Heroku

Procfile

web: node .next/standalone/server.js

Config Vars

heroku config:set NEXT_PUBLIC_API_URL=https://api.example.com
heroku config:set NEXT_PUBLIC_APP_NAME=MyApp

Coolify

Self-hosted PaaS alternative:

# docker-compose.yml for Coolify
services:
    app:
        build: .
        environment:
            - NEXT_PUBLIC_API_URL=${NEXT_PUBLIC_API_URL}
            - NEXT_PUBLIC_APP_NAME=${NEXT_PUBLIC_APP_NAME}

Set variables in Coolify's UI for each environment.

Platform Comparison

Platform	Docker	Environment UI	Secrets	Auto-scaling
Vercel	No	Yes	Yes	Yes
Railway	Yes	Yes	Yes	Yes
Fly.io	Yes	CLI	Yes	Yes
Render	Yes	Yes	Yes	Yes
AWS ECS	Yes	No	Yes	Yes
Cloud Run	Yes	CLI	Yes	Yes

General Tips

These tips apply to all platforms:

1. Use Standalone Output

Always enable standalone for production deployments:

// next.config.js
module.exports = {
    output: 'standalone',
}

Docker Image Size Standalone output reduces image size by ~10x by including only production dependencies. :::

2. Health Checks

Add a health endpoint:

// app/api/health/route.ts
export function GET() {
    return Response.json({ status: 'ok', timestamp: Date.now() })
}

Most platforms can use this for readiness and liveness probes.

3. Graceful Shutdown

Handle shutdown signals properly:

// server.js (if using custom server)
process.on('SIGTERM', () => {
    console.log('SIGTERM received, shutting down gracefully...')
    process.exit(0)
})

Next Steps

• Docker Deployment - Detailed Docker guide
• Security - Security best practices
• API Reference - Full API documentation