Skip to content

Installing EasyAdmin

Requirements

EasyAdmin is a standalone resource. It does not require any additional libraries or dependencies to work.

Installation

Choose one of the following installation methods based on your setup.

  1. Go to the latest release page and download the source code.
  2. Extract the downloaded folder (it will be named something like EasyAdmin-*version*).
  3. Rename the folder to EasyAdmin.
  4. Upload the folder to your FiveM server's resources directory using FTP.

Then continue with the rest of the setup guide.

  1. Install the required packages:
1
tar jq curl wget
  1. Navigate to your FiveM server's resources folder using the terminal:
1
cd /path/to/your/resources
  1. Run the following script to download and install EasyAdmin:
1
2
3
4
5
6
dl=$(curl -sSL https://api.github.com/repos/Blumlaut/EasyAdmin/releases/latest | jq -r .tarball_url )
mkdir EasyAdmin
wget $dl -O easyadmin.tar.gz
tar xf easyadmin.tar.gz && rm easyadmin.tar.gz
cp -Rfv *Blumlaut-EasyAdmin*/* ./EasyAdmin
rm -rf *Blumlaut-EasyAdmin*

This script can also be used to update EasyAdmin. Always check the changelog before updating.

  1. Go to the latest release page and download the source code.
  2. Extract the folder (named something like EasyAdmin-*version*) into your resources folder.
  3. Rename the extracted folder to EasyAdmin.

⚠️ If you're using txAdmin, skip this tab and use the "Manually (FTP)" or "Manually on Linux (CLI)" guides.

  1. Log in to your ZAP-Hosting dashboard.
  2. Go to the Resources tab.
  3. Search for EasyAdmin and click the Install button.

Getting Started

To start using EasyAdmin, add the following to your server.cfg file and restart your server:

1
2
3
4
ensure EasyAdmin

add_ace group.admin easyadmin allow
add_ace resource.EasyAdmin command allow

All available configuration options are in the Config Guide.

If you want to set a key to open EasyAdmin in-game, see the Keybind Guide.

Adding an Admin

Choose your method based on your hosting environment.

  1. Use this template to assign admin access:
1
add_principal identifier.IDENTIFIERNAME:IDENTIFIER group.admin
  1. Replace IDENTIFIERNAME with the type of identifier you're using (e.g., steam, discord, license).
  2. Replace IDENTIFIER with the actual identifier value.

To get your identifier: - Start the server and connect to it. - In the server console, run:

1
ea_printIdentifiers 1
(Replace 1 with your in-game ID.)

Example output:

1
2
3
identifier.steam:1100001018c7433
identifier.discord:123456789012345678
identifier.license:ABCD1234EFGH5678

To use Steam IDs, you need a Steam WebAPIKey. Follow this guide to get one.

You can also use other identifiers like discord, xbl, license, etc.

Example (using Steam):

1
add_principal identifier.steam:1100001018c7433 group.admin

📌 This method only works for ZAP-Hosting's FiveM Linux/Windows servers. For txAdmin, use the "Manually" tab.

  1. Go to the Settings page in your ZAP-Hosting dashboard.
  2. Under the Admins section, enter your Steam ID (64-bit, not Hex).
  3. Add a new line for each admin.

EasyAdmin includes support for Discord ACE permissions by default.

  1. Set up the Discord Bot first.
  2. Once the bot is running, follow this guide to configure Discord ACE permissions.