Troubleshooting
Solutions to the most common issues encountered with the Flitt addon.
📡
Server stays "Offline"
Possible causes
- ✓Addon not loaded or in the wrong folder
- ✓Invalid credentials (serverId / apiKey)
- ✓Firewall blocking outbound connections
Solutions
- →Make sure the resource is enabled (ensure flitt on FiveM)
- →Check the server console for Flitt logs
- →Ensure the firewall allows outbound connections
📊
Logs are not uploading
Possible causes
- ✓Log system (qb-log, bLogs, Helix...) is not installed
- ✓Log modules are disabled for the server
- ✓Custom events are not registered
Solutions
- →Verify the log system is active
- →Trigger a test event (e.g., a kick or a connection)
- →Check Flitt logs for registration errors
⚙️
Error "Missing configuration"
Possible causes
- ✓Credentials are not configured
- ✓Placeholders are not replaced (e.g., {API_KEY})
Solutions
- →Download the addon from the dashboard (auto-fills)
- →Or configure manually lua/autorun/server/flitt.lua
🔐
HTTP 401 / Unauthorized
Possible causes
- ✓Invalid or expired API key
- ✓API key from another server used
- ✓Incorrect server ID
Solutions
- →Regenerate an API key from the dashboard
- →Update the configuration file
- →Make sure you use the correct key for the right server
📈
Player stats are not updating
Possible causes
- ✓Server cannot reach the API (port 443 blocked)
- ✓Unstable network or blocked DNS
- ✓API rate limit exceeded
Solutions
- →Check outbound connectivity (ping api.flitt.xyz)
- →Review network logs in the server console
- →Wait a few minutes before checking again
🆘
Still stuck?
Open a support ticket from the dashboard. Include Flitt logs and your server ID (never share your API key).