Common issues
Solutions for the most frequent problems during installation and use of QuanticPhone.
Phone won't open
- Is the resource started in server.cfg? Check with the resource command in the console.
- Does the player have the phone item (if Config.Item.Require = true)?
- Are oxmysql and ox_lib started before quanticPhone?
- Check the client console for errors (press F8).
Database / SQL error
Never use phpMyAdmin to run SQL. Always use HeidiSQL or MySQL Workbench.
- Make sure you deleted all tables starting with quantic_phone_ before running the SQL file.
- Confirm your MariaDB version is 10.11 or newer.
- Check your oxmysql credentials in server.cfg (set mysql_connection_string).
- Look for errors like "Table already exists" or "Unknown column" in the console.
Phone number not generated
- The number is generated on first use. Check that quantic_phone_users exists in your database.
- With Config.Item.Unique = true, the item must have the phone_number metadata set.
- Verify that the framework is correctly reading the player's identifier.
Media upload fails
- Confirm your API key is correct in server/apiKeys.lua.
- Check that the upload method is set in Config.Upload.Method.
- For Fivemanage, make sure your server domain is authorized in the dashboard.
- For S3/R2, verify bucket permissions and access credentials.
Notifications not arriving
- Is OneSync enabled? Some notifications require OneSync to work between players.
- There is no conflict with another phone resource running at the same time.
- The recipient number is correct and the player is online.
Escrow error
Never edit files outside the
escrow_ignore block. Editing protected files corrupts the resource.- Your Cfx.re license must be active and linked to the correct server.
- The resource must be started by the same server where the license was registered.
- Verify your server.cfg has the correct license (sv_licenseKey).
- Contact support on Discord if the problem persists after checking the above.