Please whitelist the public IP of your Vodia Wallboards 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 Wallboards 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. wallboards.example.com) to your Droplet's public IP. DNS must propagate before you proceed — Vodia Wallboards 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 Wallboards 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 Wallboards 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. wallboards.example.com) to your server's public IP. Let DNS propagate before proceeding — Vodia Wallboards needs this to issue a TLS certificate automatically via Caddy.
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-wallboards/vodia-wallboards.zip
unzip vodia-wallboards.zip
cd vodia-wallboards
sudo bash install.sh
3. Answer the Prompts
The installer asks 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, and Redis. Configuration lives in .env at /opt/vodia-wallboards/.env.
Adding Your First PBX
After logging in, navigate to Settings → PBX Connections → Add PBX and enter your PBX hostname and credentials. See PBX Servers for full setup details.
CLI Tools
The installer adds several helper commands:
| Command | Description |
|---|---|
vwb-status | Show container status |
vwb-logs | Tail logs from all containers |
vwb-restart | Restart all or specific containers |
vwb-update | Rebuild and restart containers |
vwb-backup | Run a MongoDB backup |