Operations Guide¶
Running, deploying, and maintaining VitaraVox in production
Last Updated: 2026-02-16 (v4.0.1)
In This Section¶
| Page | Description |
|---|---|
| Deployment & Infrastructure | Server setup, PM2 deployment, NGINX, SSL |
| Environment Configuration | All environment variables and secrets |
| Monitoring & Troubleshooting | Common issues, PM2 monitoring, health checks |
| Vapi GitOps | Squad management, prompt pushes, tool config |
| Backup & Recovery | Database backups, OSCAR credential backup, rollback |
Quick Reference¶
| Task | Command |
|---|---|
| Check server status | pm2 status |
| View logs | pm2 logs vitara-admin-api |
| Restart server | pm2 restart vitara-admin-api |
| Deploy code changes | cd ~/vitara-platform/admin-dashboard/server && npx tsc && pm2 restart vitara-admin-api |
| Push Vapi prompts | cd ~/vitara-platform/vapi-gitops && npm run push:dev |
| Backup database | pg_dump -U vitara vitara_platform \| gzip > backup_$(date +%Y%m%d).sql.gz |
| Deploy docs | See Deployment |
| Health check | curl -s http://localhost:3002/health \| jq |
Architecture Summary¶
┌──────────────────────────────────────────────┐
│ OCI Toronto (Production Server) │
│ VM.Standard.A1.Flex — 2 OCPUs, 24GB RAM │
│ │
│ ┌──────────────────────────────────────┐ │
│ │ NGINX (host-level, port 443) │ │
│ │ SSL termination + rate limiting │ │
│ └──────────────┬───────────────────────┘ │
│ │ │
│ ┌──────────────▼───────────────────────┐ │
│ │ PM2: vitara-admin-api (port 3002) │ │
│ │ Node.js + Express + TypeScript │ │
│ └──────────────┬───────────────────────┘ │
│ │ │
│ ┌──────────────▼───────────────────────┐ │
│ │ PostgreSQL 16 (localhost:5432) │ │
│ │ Database: vitara_platform │ │
│ └──────────────────────────────────────┘ │
└──────────────────┬───────────────────────────┘
│ SOAP/WS-Security (HTTPS :8443)
▼
┌──────────────────────────────────────────────┐
│ AWS Montreal (OSCAR Dev) │
│ https://15.222.50.48:8443/oscar │
└──────────────────────────────────────────────┘