Skip to main content
Database Sync requires the Plus version or higher of Sonoran CAD.Additional features like Database Merge and Friendly Mapping require the Pro version of Sonoran CAD.For more information, see our pricing or view how to check your community limits.
Looking for VPS, web, or dedicated hosting? Check out our official server hosting!

What is DB Sync?

Database Sync allows you to search all in-game characters, licenses, and vehicle registrations stored in your FiveM database—without manually creating records in Sonoran CAD. When a lookup is performed, Sonoran CAD securely queries your FiveM framework’s database and displays the results using your custom record templates.

Configuring DB Sync

  1. Enter Connection Credentials

In order for Sonoran CAD to read your in-game database, you must configure the connection information.
Rocket Node Hosting - Database Credentials1. LoginLogin to your RocketNode game panel and navigate to your FiveM Server.2. Select the DatabaseOn the left sidebar select Databases > … menu > Details3. Copy Connection CredentialsEnter the following items from the RocketNode database details panel into Sonoran CAD
  • Endpoint
    • This includes the “Host” and “IP” portions for Sonoran CAD. From the image below, the Sonoran CAD Host would be db-ash-06.apollopanel.com and the Port would be 3306.
  • Username
    • Direct copy from RocketNode to the Sonoran CAD’s Username field.
  • Password
    • Direct copy from RocketNode to the Sonoran CAD’s Password field.
  • Database
    • Outside of the database details window the database name can be clicked to be copied and pasted into the Sonoran CAD Database field (image 2).
If your database port has not already been opened, you will need to forward/open this port.
Typically, the default MySQL port is 3306.
To check if your MySQL port has been properly opened, visit a port checking utility and enter your MySQL server’s IP address and port.If you are unsure how to open a port, you will need to contact your hosting provider.

IP Whitelisting

My community wants to whitelist only the Sonoran CAD IP address to connect on this SQL user account. How can I do this?You may whitelist the following IPs:
Last Updated : 1/15/2026

  1. Combine API and DB Sync Records

When a community uses database sync, all record lookups run against that community’s external database. Some communities may also want to include CAD records created through integrations such as ERS. Enabling this option allows lookups to return both in-game data, such as characters, licenses, and vehicles, and API-created characters and vehicles from ERS.To enable this, turn on Include CAD API records in DB Sync lookups.

  1. Automatic AI Setup

Sonoran CAD’s automatic AI setup handles all of the configuration for you. Once your connection credentials are entered correctly, select AI Automatic Setup to complete the full configuration.The AI will automatically add any primary key columns if missing, will update your license record for any additional types, and will configure friendly mapping values if your community is on the Pro version. This process typically takes 60-90 seconds.Once completed, the AI will inform you of any missing columns (record fields that don’t exist in your database) and will save the new configuration.Next, run a lookup in the police or dispatch panel to test searching for exisitng in-game characters, licenses, and vehicle registrations.

  1. Automatic Selfie/Portraits

FiveM communities can also use the Civilian Registration submodule to create automatic character photos on their db sync records.Ensure the submodule has been enabled and started, then run the AI configurator to ensure the sonoran_mugshot DB column has been mapped to your character record’s image field.

Database Merge

For security, Sonoran CAD’s database sync is read-only. It retrieves information from your in-game database but never modifies it. Available fields—such as vehicle color, hair color, and other character details—are automatically loaded into your custom record templates.If your database does not contain the information required for certain custom fields, those fields will appear blank. Database Merge allows you to manually complete these records without changing your in-game database.When you enter information into a blank field, Sonoran CAD saves the additional data separately. During future lookups, it automatically combines your in-game database information with the manually entered CAD data to display a more complete record.Database Merge is available exclusively to Pro communities and can be enabled from the Connection Credentials tab.

Friendly Mapping

Friendly mapping allows you to convert any raw database value to a more user friendly value.
Ex:
  • drive_license in your database is converted to Driver's License.
  • color1 in your database is converted to Brown.
To manually configure friendly mapping on a field, select the Modify button under the Friendly Mapping column. Enter in a raw database value and the friendly value that should be replaced.