Installation

Follow this step-by-step guide to install QuanticPhone on your FiveM server.

1. Install MariaDB

Install MariaDB version 10.11 or newer. You can check your version by running this in HeidiSQL:

SELECT VERSION();

2. Run the SQL file

Run the file quanticPhone/database.sql using HeidiSQL.

3. Install dependencies

Download and install the following dependencies before starting QuanticPhone:

• oxmysql — Required MySQL driver
• ox_lib — Utility library
• Up-to-date server artifacts — Recommended: latest version
• OneSync Infinity — Optional — required for AirShare and live location

4. Add to server.cfg

All resources used by QuanticPhone must be started before it. Place ensure quanticPhone at the end of your server.cfg, but before any custom apps.

# Dependencies (before quanticPhone)
ensure oxmysql
ensure ox_lib
ensure es_extended   # or qb-core / ox_core

# QuanticPhone
ensure quanticPhone

# Custom apps (after quanticPhone)
ensure my-custom-app

5. Configure media upload

To enable photo, video and audio uploads, configure an upload method and set your API keys.

Config.Upload = {
    Method = "fivemanage",  -- "fivemanage" | "s3" | "r2" | "discord"
}

ApiKeys = {
    Fivemanage = "your-api-key-here",
}

6. Configure

The phone works out of the box, but you can customize it to your liking. See the Configuration page. If you run into issues, check Common issues.