Installation
Requirements
| Component | Minimum | Recommended |
|---|---|---|
| OS | Ubuntu 24.04 | Ubuntu 24.04 |
| CPU | 2 vCPU | 4 vCPU |
| RAM | 4 GB | 8 GB (for AI transcription) |
| Disk | 200 GB | 500 GB+ (depends on recording volume) |
| Network | Public IP, ports 80/443 open | Dedicated domain with DNS A record |
Install Steps
1. Point Your Domain
Create a DNS A record pointing your chosen domain (e.g. cdr.example.com) to your server's public IP. Let DNS propagate before proceeding — Vodia Analytics needs this to issue the TLS certificate automatically.
2. Download and Run
apt-get install -y wget unzip
wget https://vodia.nyc3.cdn.digitaloceanspaces.com/cdrstats/cdrstats.zip
unzip cdrstats.zip
cd cdrstats
bash install.sh
3. Answer the Prompts
The installer will ask:
| Prompt | Required | Notes |
|---|---|---|
| Domain | Yes | e.g. cdr.example.com — or localhost for local dev |
| Admin email | Yes | Used as your login username |
| Admin password | Yes | Minimum 8 characters |
| OpenAI API key | No | Enables AI summaries and sentiment analysis. Transcription works without it. You could add it later under Admin settings |
| PBX IP whitelist | No | Comma-separated IPs of your Vodia PBX servers. Only these IPs can push CDR/recording data. Leave blank to allow all. You could add it later under Admin settings |
4. Wait ~5–10 Minutes
The installer will:
- Install Docker if not present
- Generate all secrets (MongoDB, Redis, MinIO, JWT)
- Build the frontend and all containers
- Start all services with auto-HTTPS via Caddy
- Configure UFW firewall
- Set up daily backup cron job
5. Verify
Open https://your-domain.com in a browser and log in with the email and password you entered.
What the installer creates
All services run in Docker containers managed by Docker Compose: Caddy (reverse proxy + auto-HTTPS), Fastify API, BullMQ worker (transcription), MongoDB 7, Redis 7, MinIO (recording storage), and Grafana (optional monitoring). Configuration lives in .env at the project root.