> ## Documentation Index
> Fetch the complete documentation index at: https://docs.r5r.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Control Panel

> Web-based tool for server management, configuration, and monitoring.

# Host Control Panel

The [Control Panel](https://r5r.dev/cp) is the hub for configuring and operating verified hosts. Tabs appear only when you have permission for them; each tab enforces its own access check. Tracker settings once edited in playlists now live here—download/apply `r5rdev_config.json` from the Config tab instead.

# Host view selection

At the top-right of the host control panel, you can select the host to switch to ( as you may be a moderator of multiple hosts ), and the server under that host your actions target.  Several actions in the control panel also have `sync to all servers` options for replicating commands.

<img src="https://mintcdn.com/r5reloaded/3Bqvw51LpFcETUl1/images/host_control_panel/host-select.png?fit=max&auto=format&n=3Bqvw51LpFcETUl1&q=85&s=31a923a8a9885797526353411f22fb26" alt="Settings" width="455" height="209" data-path="images/host_control_panel/host-select.png" />

## Tabs at a Glance

### Settings

Host title/description, API key view/regenerate, and host selector. Owners see everything; moderators only see tabs granted to them.\\

<img src="https://mintcdn.com/r5reloaded/6Mp91nHY-PjHxHAU/images/host_control_panel/settings.png?fit=max&auto=format&n=6Mp91nHY-PjHxHAU&q=85&s=ae24d77b3d3618b0b3d4ce75304d7155" alt="Settings" width="1388" height="884" data-path="images/host_control_panel/settings.png" />

### Servers

Manage each registered server’s status and settings. You can edit per-server options, including:

* **Allow showing server address**: expose the address in UI.
* **Do not share PlayerData with this host's other servers**: isolate player data for this server.
* **Keep chat log**: persist chat for later viewing (required for Chat tab history).

Use **Clone settings** to copy user permissions from this server to another user quickly.
Pick a server before running commands or chat actions. Live status relies on WebSockets.\\

<img src="https://mintcdn.com/r5reloaded/6Mp91nHY-PjHxHAU/images/host_control_panel/servers.png?fit=max&auto=format&n=6Mp91nHY-PjHxHAU&q=85&s=59af2595507cc82d3e955e31ba48cb47" alt="Servers" width="1529" height="941" data-path="images/host_control_panel/servers.png" />

### Users

Add/remove privileged users and grant granular permissions (e.g., `view_banlists`, `cmd_kick_player`). Invites require the user to allow discoverability in [Account Settings](https://r5r.dev/account?tab=settings#discoverability).

<Info>
  After giving a user privileges who did not have any, they will receive a real-time notification that they now have access to your host control panel.
</Info>

<Note>
  Users will only see tabs that they have view\_ permissions for. Additionally, actions within them will be scoped to permissions.
</Note>

<img src="https://mintcdn.com/r5reloaded/6Mp91nHY-PjHxHAU/images/host_control_panel/users.png?fit=max&auto=format&n=6Mp91nHY-PjHxHAU&q=85&s=3c10abb03584bbeb32e78d8318b5957b" alt="Users" width="1307" height="1862" data-path="images/host_control_panel/users.png" />

<Warning>
  Users added here are not automatically added as admins on servers, and must be configured in the [Config File](https://r5r.dev/cp/?tab=config)
</Warning>

<Info>
  If a user's ea account is connected to the website, their ea account uid will be displayed next to their name. Otherwise, use the [Tracker discord api](https://discord.com/channels/1182006089177387141/1193142143070523504) to fetch it if needed.
</Info>

### Banlists

View, add, and remove bans. Syncs live over WebSockets when enabled.\\

<img src="https://mintcdn.com/r5reloaded/6Mp91nHY-PjHxHAU/images/host_control_panel/banlists.png?fit=max&auto=format&n=6Mp91nHY-PjHxHAU&q=85&s=ea273451f37a59f0903adc81ddfbddb1" alt="Banlists" width="1311" height="844" data-path="images/host_control_panel/banlists.png" />

<Info>
  When the page is loaded, it always loads the cached version of the banlist. Fetching will pull the live in-memory banlist from the server you have selected.
</Info>

### Matches

Monitor live matches (where available) and review history for your servers.\\

<img src="https://mintcdn.com/r5reloaded/6Mp91nHY-PjHxHAU/images/host_control_panel/matches.png?fit=max&auto=format&n=6Mp91nHY-PjHxHAU&q=85&s=75ec66759bb3eb5f0509708c24b9ed1e" alt="Matches" width="1349" height="925" data-path="images/host_control_panel/matches.png" />

### Analytics

Host-level charts and summaries.\\

<img src="https://mintcdn.com/r5reloaded/6Mp91nHY-PjHxHAU/images/host_control_panel/analytics.png?fit=max&auto=format&n=6Mp91nHY-PjHxHAU&q=85&s=92c6fc28538df8cc7e79c0cf47a9b501" alt="Analytics" width="1360" height="806" data-path="images/host_control_panel/analytics.png" />

### Config

* Build/download `r5rdev_config.json` (API key, identifier, webhooks, server/settings/private, restricted gates).
* Use **Update Config** to push remotely when `tracker_ws_enable=1` or `USE_WEB_SOCKETS=true` (config JSON).
* Sectigo CA bundle download is available here for strict SSL.

<Note>
  Pushing config to the server and clicking 'Update Config' will apply 'settings' and 'restricted' categories immediately without having to reload the map.
</Note>

<Info>
  It is recommended to use the ui form of managing config in the [Config tab](https://r5r.dev/cp/?tab=config)
</Info>

<img src="https://mintcdn.com/r5reloaded/6Mp91nHY-PjHxHAU/images/host_control_panel/config.png?fit=max&auto=format&n=6Mp91nHY-PjHxHAU&q=85&s=2b205f56d5715ebed8830309f71cf306" alt="Config" width="1291" height="4449" data-path="images/host_control_panel/config.png" />

### Commands

Web UI for moderation commands (kick/ban/map change, config reload, etc ).

<Danger>
  Giving users permissions to get and set config should be done cautiously, as it can reveal your api key, and allow users to change admins on the server.
</Danger>

<img src="https://mintcdn.com/r5reloaded/6Mp91nHY-PjHxHAU/images/host_control_panel/commands.png?fit=max&auto=format&n=6Mp91nHY-PjHxHAU&q=85&s=147c82118feb87d9dad79968d41e0683" alt="Commands" width="1403" height="945" data-path="images/host_control_panel/commands.png" />

### Chat

Watch live chat and view the chat log. Requires `RELAY_CHAT_MESSAGES` enabled on the server and **Keep chat log** enabled in the [Servers tab](https://r5r.dev/cp/?tab=servers). WebSockets must be on for live streaming. You can also send a message to a specific player or all players. The message will appear as \[ADMIN: {name}]:

<img src="https://mintcdn.com/r5reloaded/6Mp91nHY-PjHxHAU/images/host_control_panel/chat.png?fit=max&auto=format&n=6Mp91nHY-PjHxHAU&q=85&s=7cb9c1445a1f42f85c9db36ec0cbac90" alt="Chat" width="1321" height="922" data-path="images/host_control_panel/chat.png" />

<img src="https://mintcdn.com/r5reloaded/CEyy7FnMvR4E9SY6/images/host_control_panel/webpanel-to-game.png?fit=max&auto=format&n=CEyy7FnMvR4E9SY6&q=85&s=8a3d7063b93ce352516389f1efedbb44" alt="Chat" width="1340" height="539" data-path="images/host_control_panel/webpanel-to-game.png" />

<Info>
  You cannot change the name that the message is sent as from the web panel -- it uses the logged in user's ea account id, or if not connected, the r5r.dev account name.
</Info>

### Notifications

Send real-time notifications to all website users who follow the host user.\\

<img src="https://mintcdn.com/r5reloaded/6Mp91nHY-PjHxHAU/images/host_control_panel/notifications.png?fit=max&auto=format&n=6Mp91nHY-PjHxHAU&q=85&s=d32cc6518f02eb17d03d735de0487810" alt="Notifications" width="1350" height="491" data-path="images/host_control_panel/notifications.png" />

### Logs

Review actions taken by your Control Panel privileged users.\\

<img src="https://mintcdn.com/r5reloaded/6Mp91nHY-PjHxHAU/images/host_control_panel/logs.png?fit=max&auto=format&n=6Mp91nHY-PjHxHAU&q=85&s=8665542a61cd9af4a9d7877183ea8f90" alt="Logs" width="1427" height="944" data-path="images/host_control_panel/logs.png" />