Self-Hosting the Voice Server

zerio-radio V3 sends radio voice through a voice server (zerio-voice). During the beta you run it yourself, next to your FiveM server. It’s a single program with a small config file, on Windows or Linux.

What You Need

• A Windows (10/11 or Server 2019+) or Linux machine (Ubuntu 22.04+, Debian 12+). The same machine as your FiveM server is fine.
• MySQL 8 or MariaDB 10.6+, with an empty database for the voice server. Don’t reuse your FiveM database.
• A port players can reach: TCP 30130 by default.
• zerio-radio V3 on your FiveM server.

Get Your Licence and Download

Which Licence Key?

• Production: for the server your players use. It runs on up to 2 machines at once (for example a live and a staging server).
• Development: for testing on your own PC. It only works when the voice server listens on 127.0.0.1, with up to 8 players.

Lost a key, or think someone else has it? Rotate it on the portal’s Server page. You get a new key and the old one stops working.

Set It Up

CREATE DATABASE zerio_voice;
CREATE USER 'zerio_voice'@'127.0.0.1' IDENTIFIED BY 'a-strong-password';
GRANT ALL ON zerio_voice.* TO 'zerio_voice'@'127.0.0.1';

{
  "mode": "single",
  "server": {
    "host": "0.0.0.0",
    "port": 30130
  },
  "database": {
    "url": "mysql://zerio_voice:a-strong-password@127.0.0.1/zerio_voice"
  },
  "auth": {
    "admin_token": "CHANGE_ME"
  },
  "licence": {
    "key": "zvl_your_production_key"
  },
  "updates": {
    "check": true,
    "supervisor": true
  }
}

zerio-voice.exe

netsh advfirewall firewall add rule name="zerio-voice" dir=in action=allow protocol=TCP localport=30130

sudo useradd --system --home /opt/zerio-voice --shell /usr/sbin/nologin zerio-voice
sudo chmod +x /opt/zerio-voice/zerio-voice
sudo chown -R zerio-voice:zerio-voice /opt/zerio-voice

cd /opt/zerio-voice && sudo -u zerio-voice ./zerio-voice

[Unit]
Description=zerio-voice
After=network-online.target mariadb.service
Wants=network-online.target
 
[Service]
User=zerio-voice
WorkingDirectory=/opt/zerio-voice
ExecStart=/opt/zerio-voice/zerio-voice
Restart=on-failure
RestartSec=3
KillMode=mixed
TimeoutStopSec=20
 
[Install]
WantedBy=multi-user.target

sudo systemctl daemon-reload && sudo systemctl enable --now zerio-voice
sudo ufw allow 30130/tcp

Config.VoiceServer = {
    Enabled = true,
    Domain = "",
    ServerId = "",
    PortalUrl = "https://portal.radio.zerio-scripts.com",
}

set  zerio_voice_admin_token "the same admin_token as in config.json"
setr zerio_voice_domain      "203.0.113.5:30130"
set  zerio_voice_admin_url   "http://127.0.0.1:30130"

Using a Domain

With a domain (for example radio.example.com) pointed at the voice server’s machine, players connect over a secure connection. Pick one:

• Let the voice server get its own certificate. Add this to config.json. Ports 80 and 443 must be free and open on the machine:

  "tls": { "domain": "radio.example.com", "contact_email": "you@example.com" }

• Use your own web server (when the machine already runs one on 80/443). Set "host": "127.0.0.1" in config.json and forward only /ws to the voice server. For example with Caddy:

  radio.example.com {
  	handle /ws {
  		reverse_proxy 127.0.0.1:30130
  	}
  	respond 404
  }

Then use the domain in server.cfg:

setr zerio_voice_domain "radio.example.com"

Updates

Nothing updates by itself. When a new version is out, the voice server console tells you, and so do zerio-radio admins in game. Type these in the voice server’s console:

On Linux with systemd there’s no console: stop the service, run it once in a terminal and type update, then start the service again. Or replace the zerio-voice file with the new download and restart the service.

Don’t edit or delete the .zerio-voice folder the voice server creates next to it. It holds the installed versions and this machine’s licence ID.

Troubleshooting

Still stuck? Ask in our Discord.