Start
Troubleshooting
Common console messages and symptoms, their causes and fixes, and how FX Phone handles load.
Read the server console first. Setup problems are printed with the [fx-phone:<area>] prefix and name what is missing.
#Console messages and symptoms
| Console message or symptom | Cause | Fix |
|---|---|---|
qb-core is installed but not started yet. Ensure fx-phone after your framework. |
Start order | See Start order |
framework: standalone on a framework server |
The framework started after fx-phone | Fix the order |
Config.Framework is "esx" but it is not running, detecting automatically. |
Wrong value or order | Set 'auto' or fix the order |
[fx-phone:schema] statement failed: CREATE TABLE ... |
The database user cannot create tables | Grant CREATE, ALTER, INDEX, or import install.sql by hand |
[fx-phone:schema] setup/install.sql is missing |
Incomplete copy | Copy the whole folder again |
| Phone does not open, a notice says you need a phone | No phone item |
See Item setup, or set Config.Item = false |
| "You need a phone" on ESX | ESX without ox_inventory has no inventory adapter | Install ox_inventory, or set Config.Item = false |
| Phone does not open, nothing happens | The character is not loaded yet, or another resource refuses it with AddCheck |
Wait for the character. Turn on Config.Debug and look for open refused in the F8 console |
uploads are off: ServerConfig.Upload.Provider "x" is not available |
Provider name misspelt | See Upload |
fivemanage presign failed: no API key in ServerConfig.Upload.Fivemanage |
Key missing | Add the key |
fivemanage presign failed: presigned URL request answered 401 |
Wrong or revoked key | Create a new key |
relay enrolment answered 403, retrying in 360 minutes |
The relay refused this server | Contact Fixitfy. Uploads stay off until then |
| Photos are taken but never appear | Upload provider is 'none', misspelt, or has no key |
The server console says which |
| No call audio | Voice resource missing, or started after fx-phone | Check Config.Voice and the start order |
| Nearby players do not hear ringtones | Neither fx-sound nor xsound runs, or the player switched 3D sounds off in Settings | Install one |
Config.Bank.Adapter is "x" but it is not available |
Resource not running | Fix the order or use 'auto' |
| Paying a company invoice fails | No job account for that job | Use a bank adapter with job accounts, or set cutSender to 0 |
CoinGecko prices unavailable (...) |
Outbound HTTP blocked or rate limited | Raise RefreshMinutes, add an API key, or set ServerConfig.Crypto.CoinGecko = false |
webhook#123: log dropped (HTTP 404) |
Webhook deleted | Replace the URL |
Config.CustomApps entry x skipped: invalid_ui |
ui is not an https URL or resource/path |
See Custom apps |
no free number or IBAN left for ... |
Number.Length too short for your player count |
Raise it |
Version check failed: GitHub could not be reached |
Outbound HTTP blocked | Harmless. Config.VersionCheck = false silences it |
payload for ... is ... bytes, over the 16384 byte budget |
A very large home layout or settings | Harmless. Report it with the identifier |
video calls are off: ServerConfig.Video has no TURN server, Hosted is false and AllowDirect is false |
No relay configured | See Video relay |
<resource> is switched off in Config.BundledApps, not starting it. |
The app is set to false |
Set it to true in configs/config_apps.lua |
| The tablet says no access | No role | See Admin. fxphone:admin <id> in the console tells you whether the player has one |
| The character runs on by itself with the phone open | The game missed a key release | Leave Config.MovementGuard on |
| Esc no longer opens the pause menu | The phone is open | While the phone is open, Esc closes it |
A line mentioning Content Security Policy in F8 |
The page tried to load something the policy does not allow | The line names the directive and the address. See Installation |
#Performance
How FX Phone keeps its load down:
- With the phone closed FX Phone runs no loop on the client. While it is open, one thread checks the look-around key, the pause menu and the prop every 100 ms. Calls add a 200 ms talking check only while a call is active.
- No net event is larger than 8 KB. Bigger answers are split into numbered parts. Joining sends one small bootstrap; contacts, chats, photos and feeds are loaded by the app that shows them, one page at a time.
- Server pushes carry the change, not the list. Marketplace, News and Services push live updates only to players who have that app open.
- Uploads go from the player's game to the provider. The game server only signs the request.
- Requests that move money accept an optional
requestId(8 to 64 characters): bank transfers, crypto buy, sell and transfer, invoice payments and new Marketplace listings. A repeat with the same id within 60 seconds gets the first answer instead of running again, so a retry after a slow answer never moves the money twice. Every money move also holds a per-character lock, so two moves for the same character never overlap. - Crypto prices are fetched once per interval for the whole server. GIF searches are cached for 10 minutes.
- Webhooks are queued and spaced. A slow Discord never blocks a player's request.
- The daily clean-up and the snapshot run at 04:00 and 04:30 server time and yield between pages.
#Asking for support
When you contact Fixitfy, include the version, your framework, the console lines tagged fx-phone, and the day's file from logs/ if the problem involves a logged action. Do not send config_server.lua.