# How to Whitelist Your FiveM Server (/docs/fivem/whitelist-setup)



import { Tab, Tabs } from 'fumadocs-ui/components/tabs';
import { Step, Steps } from 'fumadocs-ui/components/steps';

<Tabs items={['Via txAdmin (Recommended)', 'Via ACE Permissions', 'Via Discord Roles']}>
  <Tab value="Via txAdmin (Recommended)">
    txAdmin has built-in whitelist modes.

    <Steps>
      <Step>
        Open txAdmin Settings [#open-txadmin-settings]

        Access txAdmin through your panel. Go to **Settings → Whitelist**.
      </Step>

      <Step>
        Choose a whitelist mode [#choose-a-whitelist-mode]

        | Mode                 | Description                                                                       |
        | -------------------- | --------------------------------------------------------------------------------- |
        | **Admin-only**       | Only admins can join (maintenance/lockdown)                                       |
        | **Approved License** | Admins manually approve players via the txAdmin dashboard or `/whitelist` command |
        | **Discord Member**   | Any member of a linked Discord server can join                                    |
        | **Discord Roles**    | Only members with specific Discord roles can join                                 |
      </Step>

      <Step>
        Save and restart [#save-and-restart]

        Apply the settings. The whitelist takes effect immediately.
      </Step>
    </Steps>
  </Tab>

  <Tab value="Via ACE Permissions">
    Use the native FiveM ACE system to whitelist specific players by their identifier.

    In `server.cfg` (via **Files** in the [XGamingServer Panel](https://panel.xgamingserver.com)):

    ```ini
    add_ace group.whitelisted command.whitelist allow
    add_principal identifier.license:xxxx group.whitelisted
    add_principal identifier.steam:110000112345 group.whitelisted
    ```

    This requires a whitelist resource that checks for the ACE permission on connect. See [ACE Permissions](/docs/fivem/ace-permissions) for the full guide.
  </Tab>

  <Tab value="Via Discord Roles">
    Use a Discord-based whitelist resource like [DiscordWhitelist](https://github.com/FAXES/DiscordWhitelist) to dynamically check players' Discord roles on connect.

    <Steps>
      <Step>
        Download DiscordWhitelist [#download-discordwhitelist]

        Get it from [github.com/FAXES/DiscordWhitelist](https://github.com/FAXES/DiscordWhitelist).
      </Step>

      <Step>
        Upload and configure [#upload-and-configure]

        Upload to `resources/` via **Files**. Edit the config file with your Discord bot token and the required role IDs.
      </Step>

      <Step>
        Add to server.cfg [#add-to-servercfg]

        ```ini
        ensure DiscordWhitelist
        ```

        Restart the server. Players must have the required Discord role to connect.
      </Step>
    </Steps>
  </Tab>
</Tabs>

Related Guides [#related-guides]

* [ACE Permissions](/docs/fivem/ace-permissions)
* [txAdmin](/docs/fivem/txadmin)
* [Server Configuration](/docs/fivem/configure-your-server)