> For the complete documentation index, see [llms.txt](https://docs.rainmad.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.rainmad.com/resources/watch-admin-menu/reference/troubleshooting-and-faq.md).

# Troubleshooting and FAQ

Work down the list. Most problems print a line in the server console, the client console (**F8**) or on screen.

## The menu

**"You do not have access to the admin menu."** You have no role. Grant yourself owner (see [Installation](https://docs.rainmad.com/resources/watch-admin-menu/getting-started/installation)) and rejoin.

**Nothing happens on F6** The key is taken by another script, or you changed it after your first join. Type `/watch` to check the menu works, then rebind it in **Settings > Key Bindings > FiveM**. A new default in `cfg.lua` only reaches players who never had the binding.

**F8 opens the FiveM console and the inspector together** F8 is FiveM's own console key. Set `cfg.admin.inspectKey` to another key, or rebind **Toggle the entity inspector**.

**A tab or a button is missing** That is your role. Raise it, give your group that right in **Staff**, or move the one action with `cfg.admin.permissions`. See [Roles and groups](https://docs.rainmad.com/resources/watch-admin-menu/permissions/roles-and-groups).

**`ox_lib` or `oxmysql` errors at start** They must start before rm\_watch. Check the `ensure` order.

## Bridges

**`cfg.bridge.X = name but no adapter registered`** That name never loaded. Fix it, use `'auto'`, or set `false`. See [Bridges](https://docs.rainmad.com/resources/watch-admin-menu/configuration/bridges).

**Items, money or jobs do nothing** The inventory or framework bridge is off or wrong. Set `cfg.bridge.inventory` and `cfg.bridge.framework` to your scripts, or `'auto'`.

**Items shows only online holders** Offline holders are read where ox\_inventory, qb-inventory and the plain qb or ESX inventories save them. Other inventories keep their own storage, so only online holders are listed. A missing item picture shows a box; with ox\_inventory, pictures come from the `inventory:imagepath` convar.

## Aces

**Console tab: "Access denied for command"** Commands from the tab run as the resource. Add `add_ace resource.rm_watch command allow`, or one `command.<name>` line per command.

**"profiling needs add\_ace resource.rm\_watch command.profiler allow"** or **"Restart needs add\_ace resource.rm\_watch command.quit allow"** Add those two lines to `server.cfg`, see [server.cfg lines](https://docs.rainmad.com/resources/watch-admin-menu/configuration/server.cfg-lines).

**The server shut down but did not come back after a restart** Without txAdmin, nothing starts it again. Run the server under txAdmin or a process manager.

## Web panel

| Console line                                       | Fix                                                                                                  |
| -------------------------------------------------- | ---------------------------------------------------------------------------------------------------- |
| `rm_watch_key is not set, so the live map is off.` | Add `set rm_watch_key "..."` to `server.cfg` and restart.                                            |
| `fivemad refused the rm_watch_key`                 | The key is wrong or was replaced. Copy it again from [fivemad.com/watch](https://fivemad.com/watch). |
| `This rm_watch license has been revoked.`          | Contact us on Discord.                                                                               |
| `Cannot reach fivemad.com/watch (HTTP ...)`        | Your host blocks outbound HTTPS, or fivemad.com is down. rm\_watch keeps retrying.                   |

**The key works but a staff member cannot open the server** Add them on **Staff and roles**, **Members**, or map one of their Discord roles. See [The web panel](https://docs.rainmad.com/resources/watch-admin-menu/web-panel-and-discord/the-web-panel#who-can-open-it).

**`/watch link` fails** Only the licence owner's code works, the account typing it needs **Manage Server**, and a code is good for 15 minutes once.

## Voice

**Spectate has no sound** `cfg.spectate.voice` needs pma-voice, SaltyChat or TokoVOIP running. Other voice scripts get the picture only.

**"The staff voice channel is not available"** It needs pma-voice with radios on. `setr voice_enableRadios 0` turns them off.

**Staff hear a radio script's users in the staff channel, or cannot join it** Another script uses the same channel number. Change `cfg.voice.channel.number` to one nobody else hands out.

**The microphone button says it is blocked** In game the menu records from the **Windows default recording device**. Check that one is set, and that Windows privacy settings allow desktop apps to use the microphone. On the web panel, allow the microphone from the padlock in the address bar.

**Voice notes are refused** They need `rm_watch_key`. If the message says the storage is full, older notes have to expire first.

## Auto replay and live view

**Clips or live tiles are black or show the game's menus** Ask the player to turn DLSS, FSR and frame generation off and try again.

**A live tile shows still frames only** The player's network does not let video through. Add a TURN server to `cfg.liveview.iceServers`, see [Auto replay and live view](https://docs.rainmad.com/resources/watch-admin-menu/features/auto-replay-and-live-view#players-on-strict-networks).

**No sound** There is none, by design: a FiveM page cannot read the game's sound.

## Moderation

**A banned player got back in** Bans match every identifier and the hardware tokens; somebody would have to change all of them. Ban again while they are on and the new identifiers are added. Or add them to the [blacklist](https://docs.rainmad.com/resources/watch-admin-menu/features/mutes-community-service-whitelist-and-appeals#blacklist).

**Community service spots are in a wall or a road** The default spots are approximate. Move them in `cfg.commserv.zones`.

**Vehicle Delete keeps a car I expected it to remove** On purpose when somebody sits in it, a player stands within `keepNearMeters`, a script kept it, or `keepOwned` is on and a player owns its plate.

**Screen check finds nothing** It only sees what is drawn on screen, so it catches menus with a visible window or watermark, not hidden cheats. Reliable results need an OCR service (`rm_watch_ocr_endpoint`). It never punishes on its own.

## FAQ

**Do I need the web panel?** No. Everything in game works without a key. The web panel, the Discord bot, ban appeals, voice notes, auto replay and live view need one.

**Which files can I edit?** `cfg.lua`, everything in `bridge/`, `server/discord_log.lua`, `server/db.lua`, `server/db/*.lua` and the `locales` JSON files are not encrypted.

**Can I rename the folder?** No. Exports, events and ace lines use the name `rm_watch`.

**How do I update?** Back up `cfg.lua`, `server/discord_log.lua` and any locale edits, replace the folder, put your files back and restart. New tables and columns are added on their own, and nothing in your database is lost.

**Does the same licence work for RedM?** Yes, the key works in `rm_watch_redm` too. See [RedM installation](https://docs.rainmad.com/resources/watch-admin-menu/redm/installing-on-redm).

**Does rm\_watch store IP addresses?** The last IP of each player is kept for the owner's search in game. It is never shown on the web panel, and a search by address is written to the staff log.

## Reporting a problem

Open a ticket in our [Discord](https://discord.gg/rainmad) with:

1. **The client console (F8):** the red lines, as text if you can.
2. **The server console** from the minute it happened, especially `SCRIPT ERROR`, `[ERROR]` and `SQL` lines.
3. **A screenshot** of what you saw in the menu or the web panel. For the web panel, the browser console (F12) helps too.
4. **One line** on what you did: which action, on whom, from the game or the web. For example: "jail 5 min on Tester from the web, the player did not go to the cell".
5. Your `cfg.lua`.

If a garage, stable or inventory shows the wrong data, also send the layout of the table it uses (`SHOW CREATE TABLE <name>;` in your database tool).
