# Troubleshooting

How to fix a resource that won't connect, an offline bot, deliveries that don't arrive, a pending Pix, a closed dashboard and sign-in errors.

Source: https://fivedash.fivex.gg/docs/en/help/troubleshooting

When something doesn't work, FiveDash almost always tells you why: in the dashboard, in the FiveM server console or on the Discord screen. This page gathers the real messages you'll see and what to do about each one. Look for the sentence you're seeing.

## Before you start

* Many fixes require the **Owner** or **Admin** role (server key, plan, bot).
* For resource problems, have access to the FiveM server console. The `fivedash status` command shows almost everything at once.

## The fivedash resource won't connect

First, run this in the server console:

```bash
fivedash status
```

It shows the framework, the dashboard (`connected`, `connecting`, `offline`, `refused` or `no key`), the server in FiveDash and the syncs.

| Console message                                                                                                | Cause                                                          | What to do                                                                                                |
| -------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------- |
| `No dashboard key: this server isn't connected to FiveDash.`                                                   | `Key` in `config.lua` is empty                                 | Generate the key in **Server → Game connection → Connect server** and paste it into `fivedash/config.lua` |
| `The dashboard key doesn't look right (it starts with fdk_). Check Key in config.lua.`                         | The key was pasted wrong                                       | Copy it again, with quotes: `Key = "fdk_xxxxxxxx",`                                                       |
| `The dashboard refused the connection: key refused by the dashboard.`                                          | The key was replaced or the server was disconnected            | Generate a new key and replace `Key` in `fivedash/config.lua`                                             |
| `The dashboard refused the connection: this key is already in use by another server that's running right now.` | Two servers with the same key                                  | Each server has its own. If you just restarted fivedash, it gets back in by itself in a few seconds.      |
| `The dashboard refused the connection: this resource version is no longer accepted.`                           | The resource is too old                                        | Download the new version from **Game connection → Download the latest version**                           |
| `No connection to the dashboard (…). Retrying automatically.`                                                  | The server's internet or the dashboard was briefly unavailable | Wait: the resource retries on its own                                                                     |
| `fivedash's config.lua is missing…`                                                                            | The file was deleted                                           | Download the resource again or create the file with the `Key` line                                        |

| In the dashboard                                                                            | What to do                                                                                                                                           |
| ------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Waiting for the server to connect…** never finishes                                       | Check that `ensure fivedash` is in `server.cfg`, after the framework, and that the resource started (`refresh` and `ensure fivedash` in the console) |
| **Disconnected** on the **Game connection** card                                            | The server hasn't synced for more than about 75 seconds. Check the city is running and run `fivedash status`.                                        |
| **No version of the resource has been published yet** or **Couldn't download the resource** | Try again in a moment. If it keeps happening, contact support.                                                                                       |
| **Only the organization's owners and admins can connect the server.**                       | Ask an owner or admin                                                                                                                                |
| **This server already has a key (…).**                                                      | The key is only shown when generated. If you didn't save it, click **Generate another key** (the old one stops working).                             |

## The framework wasn't detected

| Message                                                                         | What to do                                                                                                                                                                    |
| ------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **None detected** in the dashboard / `No known framework found…` in the console | The connection works, but the whitelist stays on Discord and the store only delivers commands. Start the framework before fivedash in `server.cfg` and run `fivedash detect`. |
| `Framework "…" from config.lua wasn't found on this server`                     | The `Framework` value in `config.lua` is wrong. Use `"auto"` or one of: `"creative-enchanted"`, `"qbox"`, `"qbcore"`, `"esx"`, `"ox-core"`, `"vrp"`.                          |
| `… isn't supported by FiveDash yet`                                             | The framework isn't supported: whitelist on Discord only and store by commands only                                                                                           |
| `No MySQL driver started (oxmysql, mysql-async or ghmattimysql)`                | Start one of those drivers before fivedash                                                                                                                                    |
| **Whitelist via FiveDash: Unavailable** or **Not supported yet**                | The detected framework can't unlock whitelist in game right now. See [Frameworks](https://fivedash.fivex.gg/docs/en/developers/frameworks).                                   |

## The server's modules won't open

| What shows                                                 | Why                                                             | What to do                                                                                                            |
| ---------------------------------------------------------- | --------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- |
| **Connect …** · **One step before setting up the modules** | The fivedash resource hasn't connected even once on this server | Install the resource. See [Install the resource](https://fivedash.fivex.gg/docs/en/getting-started/install-resource). |
| Module with a lock (**… · not in your plan**)              | The module isn't in the plan                                    | Owner or admin: **Add … to the plan**                                                                                 |
| Page with a **Pro** tag                                    | The page belongs to the Pro plan                                | Owner or admin: **Switch to Pro**                                                                                     |
| The module doesn't show at all                             | You don't have access to any of its pages on this server        | Ask an owner or admin for access                                                                                      |

## The Discord bot is offline

Check the status in **Discord → Bot**.

| Status             | What it means                                                                            | What to do                                                                                         |
| ------------------ | ---------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- |
| **Online**         | Connected: joins, suggestions, protection and interview rooms arrive instantly           | Nothing                                                                                            |
| **Starting**       | Starting on the Gateway. It takes a few minutes and the page updates on its own.         | Wait                                                                                               |
| **Offline**        | Commands keep working, but joins, suggestions, protection and interview rooms are paused | Click **Check connection**. If it stays offline, contact support.                                  |
| **Token rejected** | Discord rejected the token: commands stop responding                                     | Generate a new token in **Bot → Reset Token** in the Developer Portal and click **Save new token** |

| Message when connecting the bot                                                             | What to do                                                                                                           |
| ------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- |
| **Discord rejected this token. Generate a new one in Bot → Reset Token and paste it here.** | Generate another token and paste it                                                                                  |
| **This doesn't look like a bot token.**                                                     | Copy the token from the **Bot** tab in the Developer Portal                                                          |
| **This bot is already connected to another FiveDash server.**                               | Use another bot for this server                                                                                      |
| **The bot isn't in that Discord server.** / **The bot is no longer in … Add it again.**     | Add the bot to the Discord server again                                                                              |
| **Missing: …** (permissions)                                                                | Click **Update permissions**                                                                                         |
| **Turn it on in Bot → Privileged Gateway Intents and save the changes.**                    | Turn on **Server Members Intent** (and **Message Content Intent**, used by logs and tickets) in the Developer Portal |
| **We couldn't register the commands.**                                                      | Click **Add again**                                                                                                  |
| **Discord asked us to slow down.**                                                          | Try again in a few seconds                                                                                           |

Details in [Bot](https://fivedash.fivex.gg/docs/en/discord/bot).

## A store purchase didn't arrive in game

Open the order in **Store → Orders**.

| Order state                    | What it means                                                            | What to do                                                                                                                                 |
| ------------------------------ | ------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------ |
| **Awaiting payment**           | The player hasn't paid yet. The order expires on its own if nobody pays. | Nothing, or ask the player to pay                                                                                                          |
| **Paid, waiting for delivery** | The city delivers as soon as the player is online                        | Ask the player to join the city. Delivery happens a few seconds after they pick their character.                                           |
| **Delivery failed**            | The payment went through, but the city couldn't deliver                  | Check the **Game ID**, fix it if it was wrong and click **Resend to the city**. If you handed it over yourself, use **Mark as delivered**. |
| **Closed without payment**     | The payment wasn't made in time                                          | The player needs to buy again                                                                                                              |

Also check:

* The resource is **Connected** in **Server → Game connection**.
* In `fivedash/loja.lua`, `Enabled = true`. Off, the store's site stops selling until you turn it back on.
* If `AllowedCommands` has a list, the product's command must start with one of its entries.
* `fivedash status` shows how many deliveries are waiting for players.

See [In-game delivery](https://fivedash.fivex.gg/docs/en/store/in-game-delivery) and [Orders](https://fivedash.fivex.gg/docs/en/store/orders).

## Logs don't arrive

| Cause                             | What to do                                                                         |
| --------------------------------- | ---------------------------------------------------------------------------------- |
| Sending through the export is off | In `fivedash/logs.lua`, check `Enabled = true`                                     |
| The log's key is in `Disabled`    | Remove the key from the `Disabled` list                                            |
| `AllowedResources` has a list     | The resource sending the log must be on the list, or leave the list empty          |
| Wrong log key                     | Use the log's key from **Logs → the log → How to send**                            |
| Plan limit                        | Logs received per month: 1 million on Plus, 10 million on Pro, 50 million on Ultra |

After changing `logs.lua`, run `restart fivedash`. See [Create logs](https://fivedash.fivex.gg/docs/en/logs/create-logs).

## The plan's Pix doesn't confirm

| What shows                                                                                               | What to do                                                                                        |
| -------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- |
| **Waiting for payment**                                                                                  | Confirmation shows up on its own, within seconds, once the bank approves. Don't close the window. |
| **Expired**                                                                                              | Each QR code is valid for 30 minutes. Click **Create another Pix**.                               |
| **This charge is no longer open. Create a new one.**                                                     | Create a new Pix                                                                                  |
| **Tell us who's paying: name and CPF or CNPJ.** / **Invalid CPF or CNPJ.**                               | Fix the details under **Who's paying**                                                            |
| **Pix payments are unavailable right now. Try again in a moment.** / **Couldn't reach Woovi right now.** | Try again in a moment                                                                             |
| **Woovi refused the request: …**                                                                         | Check the payer details. If it keeps happening, contact support.                                  |
| **The plan is no longer paid up. Pay for the plan before the extra server.**                             | Pay for the plan first                                                                            |
| **Pix coming soon** / **Pix payments are coming soon.**                                                  | Pix isn't available for your organization yet: contact support                                    |

In **Settings → Plan → Payments**, each Pix shows as **Paid**, **Pending**, **Expired** or **Replaced** (when you created another one instead).

## The dashboard is closed

| Screen                                       | Why                                          | What to do                                            |
| -------------------------------------------- | -------------------------------------------- | ----------------------------------------------------- |
| **The organization doesn't have a plan yet** | Nobody picked the plan                       | Ask the owner or an admin to pick it                  |
| **Your free trial has ended**                | The 7-day trial ended without payment        | Owner or admin: **Pay … with Pix**                    |
| **The organization's plan has expired**      | The paid period ended without payment        | Owner or admin: **Pay … with Pix** or **Change plan** |
| **Organization suspended**                   | The FiveDash team suspended the organization | **Contact support**                                   |

Nothing is deleted in these cases: **Your data, bots and settings are still stored.**

## Plan limits

| Message                                                                                         | What to do                                                             |
| ----------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------- |
| **The … plan includes up to N products per store. Change plans to get more.**                   | Change tier or remove products                                         |
| **The … plan includes up to N logs per server.**                                                | Change tier or delete logs                                             |
| **The plan has 1 server, already in use. Add an extra server (…/month) before adding another.** | Add an extra server to the plan                                        |
| **Doesn't fit …: …**                                                                            | Your usage exceeds the chosen tier. Pick another tier or reduce usage. |
| **A custom domain is part of the Pro plan.**                                                    | Switch to Pro or Ultra                                                 |

## Account and sign-in problems

| Message                                                                        | What to do                                                                       |
| ------------------------------------------------------------------------------ | -------------------------------------------------------------------------------- |
| The verification code doesn't arrive                                           | Check spam and use **Resend** (every 60 seconds)                                 |
| **Confirm your e-mail to continue.**                                           | Enter the 6-digit code from your e-mail                                          |
| **Too many wrong attempts. For your security, wait 15 minutes and try again.** | Wait 15 minutes                                                                  |
| **This sign-in attempt has ended. Sign in again.**                             | Click **Sign in again**                                                          |
| **Create a password in Security first: it confirms it's you.**                 | The account signs in with Discord. Create a password in **Settings → Security**. |
| **This account has been suspended. Contact support: …**                        | Contact support at the e-mail in the message                                     |
| **Your session expired. Sign in again.**                                       | Sign in again                                                                    |

## Server address refused

| Message                                                                     | What to do                                                     |
| --------------------------------------------------------------------------- | -------------------------------------------------------------- |
| **Use a cfx.re/join link or an IP like 0.0.0.0:30120.**                     | Fix the format                                                 |
| **We couldn't find a server with this code.**                               | Check the `cfx.re/join` code                                   |
| **The server didn't respond. Check that it's online and the port is open.** | Start the server and open the port, or leave the address empty |
| **This address isn't public.**                                              | Use the public IP                                              |
| **This server is already in another FiveDash organization.**                | Contact support at the e-mail in the message                   |

## Invites

| Screen                                 | What to do                                                                          |
| -------------------------------------- | ----------------------------------------------------------------------------------- |
| **This invite is for another account** | Sign in with the e-mail that got the invite (**Sign in as …**)                      |
| **Invite unavailable**                 | Ask for a new invite                                                                |
| **Transfer unavailable**               | It was canceled, declined or expired (valid for 7 days). Ask the owner for another. |

## Still stuck?

See [Support](https://fivedash.fivex.gg/docs/en/help/support) to reach the FiveDash team. Include the exact message you see and, for the resource, the output of `fivedash status` (without the key).

## Next steps

[FAQ](https://fivedash.fivex.gg/docs/en/help/faq)

Quick answers.

[Support](https://fivedash.fivex.gg/docs/en/help/support)

Reach the FiveDash team.

[Install the resource](https://fivedash.fivex.gg/docs/en/getting-started/install-resource)

Step-by-step install.

[Plans and billing](https://fivedash.fivex.gg/docs/en/getting-started/plans-and-billing)

Pix, trial and expiry.
