Deploy the docs portal to Coolify
Build and run the standalone documentation application as an independent, stateless Coolify service.
Deployment boundary
Deploy the docs portal as a separate Coolify application and hostname. It is stateless, has no database, does not need V Chat credentials, and remains independent from the API/dashboard/worker Compose stack and the existing marketing landing page.
Coolify settings
| Setting | Value |
|---|---|
| Build pack | Dockerfile |
| Base directory | / |
| Dockerfile location | /apps/docs/Dockerfile |
| Port | 3000 |
| Health path | /api/health |
| Required secrets | None |
Build and verify locally
docker build -f apps/docs/Dockerfile -t vchat-docs:local .
docker run --rm -p 3000:3000 vchat-docs:local
curl --fail http://127.0.0.1:3000/api/healthRollout and rollback
- Build an immutable image from the reviewed docs branch and record its digest.
- Deploy to a staging docs hostname and run route, search, responsive, keyboard, link, and health smoke checks.
- Promote the same digest to the public docs hostname.
- Rollback by restoring the prior image digest and redeploying. No database action is needed.