important

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

CPU Compatibility — MongoDB Requirement

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

note

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.

What the installer creates

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