Please whitelist the public IP of your Vodia Wallboards server in your Vodia PBX System Security Settings to prevent it from being blocked.
Installation
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 |
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 a named model (e.g. host, Skylake-Client, or SandyBridge) rather than a generic one.
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 and admin email. It then generates a secure random admin password and all cryptographic secrets automatically. Once complete, all services start with HTTPS via Caddy.
At the end of the install you will see your credentials:
Admin credentials (save these now):
Email: admin@wallboards.example.com
Password: a3f8c1d2e4b5a6f7c8d9e0a1
Save these — the password is stored in /opt/vodia-wallboards/.env if you need to retrieve it later.
4. Verify
Open https://your-domain.com in a browser and log in with the credentials shown at the end of the install.
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 |