Deployment Overview

Deployment Overview

NuSaaS supports two different deployment tracks. Choose one and follow it consistently.

1. Self-Hosted

Use the self-hosted track if you want to run the full stack on your own infrastructure.

This path includes:

• Docker Compose on your VPS or server
• frontend on port 4001
• docs on port 4002
• API on port 4000
• WebSocket on port 8083
• host-level Nginx or equivalent reverse proxy

Start here:

• System Requirements
• Docker Stack Setup
• Environment Configuration
• Reverse Proxy & SSL

2. Managed Cloud / Pages Split

Use the managed cloud track if the public frontend and docs are hosted on Cloudflare Pages while the backend remains on the VPS.

This path includes:

• frontend on https://nusaas.com
• docs on https://docs.nusaas.com
• API on https://api.nusaas.com
• WebSocket on wss://ws.nusaas.com
• managed cloud env files: .env.cloud and web/.env.cloud

Start here:

• Cloudflare Pages Deployment

Important

Do not mix the two paths in the same setup documentation:

• self-hosted examples use app.yourdomain.com, docs.yourdomain.com, and api.yourdomain.com
• managed cloud examples use the NuSaaS public domains and Cloudflare Pages custom domains