Installation

Extract Files#

Download the release zip, transfer it to your server, and unzip on the server — don't copy individual files. Place the extracted folder in resources/.

Configure Settings#

Edit config/config.lua. These five fields must be set before starting:

config/config.lua

Config = {
    serverAddress = "localhost", -- Ships as "localhost" — only works for a server on your own PC.
                                 -- Set to "" to auto-detect your public IP, or set it explicitly:
                                 -- "http://YOUR_SERVER_IP:7777"
    serverPort    = 7777,        -- Port for the voice server (must be unused)
    authToken     = "CHANGE_ME", -- Secret key — set a random string, 20+ characters
    adminPassword = "141",       -- Web admin panel password — change before going live
    dispatchNacId = "141",       -- Code dispatchers enter on the dispatch panel login screen
}

Setting adminPassword = "" disables password login for the admin panel entirely — do this only if you use Discord authentication instead.

Open Your Port#

The radio voice server needs its own port — separate from FiveM (30120) and txAdmin (40120). You cannot reuse an existing port.

Web Panel Hosting (Pterodactyl / Most Providers)#

1. In your hosting panel find Network, Ports, or Allocations and add a new port (e.g., 50978)
2. Update config/config.lua:

config/config.lua

Config = {
    serverPort    = 50978,
    serverAddress = "http://YOUR_SERVER_IP:50978",
}

3. Restart the entire server from the panel — not just the resource
4. Verify at portchecker.co while the resource is running

VPS / Dedicated Server#

Open the port in your firewall and set serverAddress = "" — the script auto-detects your public IP.

# Ubuntu/Debian
sudo ufw allow 7777

# CentOS/RHEL
sudo firewall-cmd --permanent --add-port=7777/tcp && sudo firewall-cmd --reload

# Windows Server
netsh advfirewall firewall add rule name="Radio" dir=in action=allow protocol=TCP localport=7777

Home Server#

Forward port 7777 (TCP) in your router settings and set your public IP in serverAddress:

config/config.lua

Config = { serverPort = 7777, serverAddress = "http://YOUR_PUBLIC_IP:7777" }

Common Port Mistakes#

• Using port 30120 or 40120 — already taken by FiveM / txAdmin
• Leaving serverAddress = "localhost" on a remote server — players can't reach it
• serverPort and the port in serverAddress don't match
• Wrong serverAddress format — must include the http:// prefix and the port: "http://IP:PORT"
• Testing before the resource starts — the port only opens when tRadio is running
• Assuming your hosting panel opened the port — always verify with portchecker.co

Start the Resource#

server.cfg

ensure tLib
ensure tRadio

Use your actual folder name (e.g., ensure [tScripts]/tRadio if it's in a category bracket folder). Restart your server. A successful start prints:

 +----------------------------------------------------+
 |  Tommy's Radio - System Ready                      |
 |  Version: v6.3                                     |
 |  Panel:   http://192.0.2.100:7777/                 |
 |  NAC ID:  141                                      |
 +----------------------------------------------------+

Create Your First Channels#

A fresh install has no zones, channels, or codeplugs — you create them in the admin panel. Open http://your-server-ip:port/admin in a browser, log in with adminPassword, and follow the Minimal Working Example below. Everything configured in the admin panel applies live — no restart needed.