Please whitelist the public IP of your Vodia Monitor server in your Vodia PBX System Security Settings to prevent it from being blocked.
Installation
DigitalOcean Marketplace
The easiest way to get started is via the DigitalOcean Marketplace — no manual setup required.
→ Vodia Monitor on DigitalOcean Marketplace
Steps
1. Create Your Droplet
Click the link above and deploy a new Droplet. Choose a size that meets the requirements below. Once the Droplet is running, make note of its public IPv4 address.
2. Point Your Domain
Create a DNS A record pointing your chosen domain (e.g. monitor.example.com) to your Droplet's public IP. DNS must propagate before you proceed — Vodia Monitor needs this to issue a TLS certificate automatically.
3. First-Time Setup
Wait approximately 10–20 minutes after the Droplet starts, then open:
http://your_droplet_public_ipv4
You will be prompted to enter your domain name, admin email address, and admin password. Once submitted, Vodia Monitor will configure itself and redirect you to the login portal.
4. Access the Application
After setup completes, access your instance at:
https://your_domain
Log in with the credentials you set during first-time setup.
Self-Hosted Installation
Vodia Monitor uses MongoDB 7, which requires a CPU that supports AVX (Advanced Vector Extensions). This is available on Intel Sandy Bridge (2011) or newer, and AMD Bulldozer (2011) or newer.
Older CPUs or virtual machines configured with a generic or legacy CPU model (e.g. QEMU's default kvm64) may not expose AVX even if the underlying hardware supports it — and MongoDB will fail to start.
If MongoDB fails to start, check your hypervisor's CPU type settings and set it to expose a named CPU model (e.g. host, Skylake-Client, or SandyBridge) rather than a generic one.
For servers outside of DigitalOcean, or if you prefer a manual install.
Requirements
| Component | Minimum | Recommended |
|---|---|---|
| OS | Ubuntu 24.04 | Ubuntu 24.04 |
| CPU | 2 vCPU | 4 vCPU |
| RAM | 4 GB | 8 GB |
| Disk | 50 GB | 100 GB |
| 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. monitor.example.com) to your server's public IP. Let DNS propagate before proceeding — Vodia Monitor needs this to issue a TLS certificate automatically.
2. Download and Run
Please allow 10 to 20 minutes for the initial installation
apt-get install -y wget unzip
wget https://cdn.vodia.net/vodia-monitor/vodia-monitor.zip
unzip vodia-monitor.zip
cd vodia-monitor
sudo bash install.sh
3. Answer the Prompts
The installer will ask for your domain, admin email, and admin password. Once complete, all services start automatically with HTTPS via Caddy.
4. Verify
Open https://your-domain.com in a browser and log in with the credentials you entered.
All services run in Docker containers managed by Docker Compose: Caddy (reverse proxy + auto-HTTPS), Fastify API, MongoDB, Redis, and BullMQ workers. Configuration lives in .env at the project root.
Adding Your First PBX
After logging in, navigate to Admin → PBX Servers → Add PBX and enter your PBX hostname and credentials. See PBX Servers for full setup details.