Installation Guide

SwiftChat is a self-hostable, multi-tenant SaaS. The recommended production stack is Docker + Nginx + managed Postgres. All commands below assume Linux (Ubuntu 22.04+) or macOS.

1. System requirements

• CPU: 4 vCPU (production) · 2 vCPU (staging)
• RAM: 8 GB minimum · 16 GB recommended
• Storage: 50 GB SSD for the app + backup volume
• OS: Ubuntu 22.04 LTS, Debian 12, or any Docker-capable host
• Postgres: 15+ with the pgvector and pg_cron extensions
• Node.js: 20+ (only needed if building from source)

2. Clone and configure

git clone https://github.com/your-org/wadiff.git
cd wadiff
cp .env.example .env

Edit .env and set every required secret (see the Administrator Guide for the full list).

3. Bring the stack up

docker compose up -d
docker compose logs -f app

Wait for the readiness probe at http://localhost:8080/api/public/health/ready to return 200.

4. First-run wizard

Open https://<your-domain> and complete the on-screen wizard:

1. Create the super-admin account
2. Connect Postgres (auto-detected inside Compose)
3. Paste your WhatsApp Cloud API credentials
4. Select an AI provider (Lovable AI is preselected)

5. Verify install

• Homepage renders
• /api/public/health returns ok
• Super-admin can sign in and see the platform dashboard

If any check fails, jump to the Troubleshooting Guide.