This guide covers solutions to the most common FiveM server issues — TXAdmin access problems, CFX license key errors, database connection failures, server crashes, player connection issues, and resources not loading. For initial server setup, see the FiveM Server Setup Guide.
General troubleshooting tip: Always check the GPanel console output and TXAdmin logs first. Most errors produce a clear message that points to the cause.
TXAdmin Not Loading or Inaccessible
- Verify the server is running in GPanel — TXAdmin only starts when the FiveM server process is active.
- Check the GPanel console for the TXAdmin URL and port. The TXAdmin port is different from the game port.
- Make sure you are using
http://nothttps://— TXAdmin does not use SSL by default. - If TXAdmin was working before but stops loading, try restarting the server from GPanel.
- Clear your browser cache or try an incognito/private window.
Lost your TXAdmin password? If you cannot log in, you may need to delete the TXAdmin profile data and re-run the setup wizard. Check the GPanel Files tab for TXAdmin's data directory and remove its profile files, then restart the server.
CFX License Key Errors
| Error Message | Cause | Solution |
|---|---|---|
Invalid license key |
Key copied incorrectly or extra whitespace | Go to Keymaster, confirm the key is active, and re-copy it carefully. Paste it into both the GPanel Startup variable and sv_licenseKey in server.cfg. |
License key already in use |
Key is registered to a different server IP | Each key can only be used on one server at a time. Revoke the old key on Keymaster and generate a new one with your current server IP. |
Unable to verify license key |
Cfx.re authentication servers are temporarily unavailable | Wait a few minutes and restart the server. Check status.cfx.re for outages. |
Tip: Ensure the key is set in both the GPanel Startup variable and in
server.cfg (sv_licenseKey). Depending on your configuration, the server may read from one or the other.
Database Connection Errors
| Error Message | Cause | Solution |
|---|---|---|
Connection refused or ETIMEDOUT |
Wrong database host or port | Double-check the database host address and port from the GPanel Databases tab. Do not use localhost or 127.0.0.1. |
Access denied |
Wrong username or password | Copy credentials directly from GPanel to avoid typos. Passwords are case-sensitive. |
Unknown database |
Database name does not match | Ensure the database name in your connection string matches exactly what is shown in GPanel. |
Additional database troubleshooting steps:
- If using oxmysql, ensure you have the
oxmysqlresource in yourresources/folder and thatensure oxmysqlappears in server.cfg before any resources that require a database. - If your password contains special characters such as
@,#, or%, URL-encode them in the connection string (e.g.@becomes%40). - Test your connection string for missing or extra characters — even one misplaced character will cause a failure.
Do not use localhost. The database server is separate from the game server. Always use the full host address shown in the GPanel Databases tab.
Server Crashes on Startup
- Check the GPanel console for error messages. Common causes include a missing or misconfigured
server.cfg, an invalid CFX license key, or a broken resource. - Try disabling custom resources by commenting them out in server.cfg (add
#before eachensureline) and restart. Add them back one at a time to identify the problematic resource. - Ensure the ports in
endpoint_add_tcpandendpoint_add_udpmatch your GPanel assigned port.
# Comment out resources to isolate the problem
#ensure suspicious-resource
#ensure another-resource
# Keep core resources enabled
ensure mapmanager
ensure spawnmanager
ensure sessionmanager
ensure hardcap
ensure chat
Binary search for bad resources: If you have many resources, comment out half at a time rather than one by one. This narrows down the problem much faster.
Players Cannot Connect
- Confirm the server shows Running in GPanel.
- Verify the IP and port — players should use the game port, not the TXAdmin port.
- Check that
sv_maxclientsis not set to 0 or an unreasonably low number. - If using a server password (
sv_passwordin server.cfg), make sure players know it. - Players must have the FiveM client installed — they cannot connect using the regular GTA V launcher.
- Check the GPanel Network tab and confirm the ports in
endpoint_add_tcpandendpoint_add_udpmatch. A mismatch will prevent connections.
Server not in the browser? New servers can take 5-15 minutes to appear in the FiveM server list. Use direct connect (
IP:PORT) in the meantime. Also verify that your sv_licenseKey is valid.
Resources Not Loading
- Check that the resource folder is inside the
resources/directory (or an appropriate subfolder). - Verify the folder name matches the
ensureline in server.cfg exactly (case-sensitive). - Each resource must contain a valid
fxmanifest.lua(or the older__resource.lua). If this file is missing, the resource will not load. - Check the TXAdmin or GPanel console for error messages related to the resource. Common errors include missing dependencies or Lua syntax errors.
- If the resource requires a framework (ESX, QBCore), make sure the framework is loaded before the resource in server.cfg.
- If the resource requires a database, make sure your MySQL resource (oxmysql, mysql-async) is loaded and the database connection is working.
Check the folder structure. A common mistake is uploading a resource and ending up with a double-nested folder like
resources/my-resource/my-resource/fxmanifest.lua. The manifest must be directly inside the resource folder: resources/my-resource/fxmanifest.lua.
Server Performance Issues
- Open TXAdmin and check the Dashboard for performance metrics (tick time, player count, memory usage).
- A healthy FiveM server should maintain a server tick time (also called "hitch") below 20ms. Consistent spikes above this indicate a resource is using too much processing time.
- Use the TXAdmin Resources page to identify which resources are consuming the most server time.
- Remove or replace poorly optimised resources. Free resources from unknown sources are often the cause of performance problems.
- Reduce the number of loaded resources if your server plan's memory or CPU limits are being reached.
Getting Help
If you have tried the solutions above and are still experiencing issues:
- Copy the full error message from the GPanel console or TXAdmin log.
- Note which troubleshooting steps you have already tried.
- Open a support ticket at https://legionhosting.net/submitticket.php with this information. Our team will assist you as quickly as possible.