Cfx.re Portal : créer et gérer la clé de licence de son serveur FiveM ou RedM

Aucun serveur FiveM ou RedM ne démarre sans clé de licence, la valeur que FXServer lit dans la variable sv_licenseKey. Cette clé est gratuite et se crée aujourd'hui sur le Cfx.re Portal : la documentation officielle de FXServer demande de l'enregistrer là avant toute installation, et l'ancienne adresse keymaster.fivem.net renvoie désormais automatiquement vers portal.cfx.re. Ce tutoriel s'adresse aux administrateurs de serveurs FiveM et RedM, sur une offre mutualisée avec panel comme sur un VPS ou un serveur dédié. Il montre comment créer la clé pas à pas, où la coller (server.cfg en SSH ou sous Windows, panel, txAdmin), comment la gérer au quotidien (une clé par serveur, changement d'hébergeur ou d'adresse IP, limite de 48 slots et abonnement Element Club), ce que la fiche du serveur dans le Portal change pour la liste publique, et comment corriger les erreurs les plus fréquentes.

Cfx.re Portal : ce qui a remplacé Keymaster, et quand

Cfx.re, l'équipe qui développe FiveM et RedM, a présenté le Portal le 2 décembre 2024 sur son forum officiel : un espace web reconstruit de zéro pour gérer ses serveurs, ses créations (les ressources protégées par l'asset escrow) et ses abonnements. La même annonce précisait que Keymaster serait retiré progressivement. Les étapes qui ont suivi :

• 2 décembre 2024 : ouverture du Portal. Patreon n'accepte plus de nouvelles adhésions, les abonnements en cours restant assurés jusqu'au 1er décembre 2025.
• 15 octobre 2025 : les pages Assets et Grants de Keymaster sont retirées et remplacées par des liens vers les rubriques correspondantes du Portal.
• 21 octobre 2026 : le nom, la description, les tags, la langue et les visuels affichés dans la liste des serveurs se gèrent dans le Portal, et plus dans les fichiers de configuration du serveur. Le changement s'applique à FiveM comme à RedM.
• Aujourd'hui : keymaster.fivem.net redirige vers portal.cfx.re. Les tutoriels qui envoient encore vers Keymaster décrivent une interface qui n'existe plus.

Un point de vocabulaire, car les deux termes cohabitent : le Portal parle de server registration key (clé d'enregistrement du serveur), alors que la documentation de FXServer et la plupart des panels d'hébergement parlent de license key. C'est la même chaîne de caractères, celle que le serveur présente aux services de Cfx.re à chaque démarrage pour s'authentifier.

Clé de licence FiveM : les termes à connaître

Les forums, la documentation de Cfx.re et les panels d'hébergement n'emploient pas toujours les mêmes mots. Voici ceux qui reviennent dans la suite de ce tutoriel.

Avant de commencer : choisir le bon compte Cfx.re

Le Portal s'utilise avec votre compte Cfx.re, celui du forum Cfx.re et celui que txAdmin vous demande de lier lors de sa première configuration. Le choix du compte qui crée la clé n'est pas anodin, pour trois raisons :

• Les scripts protégés par l'asset escrow sont rattachés au compte qui les a achetés. Ils ne démarrent que sur un serveur dont la clé appartient à ce même compte. Avec une clé créée ailleurs, la console affiche « You lack the required entitlement » et la ressource refuse de se lancer.
• L'abonnement Element Club, nécessaire au-delà de 48 joueurs, se souscrit lui aussi depuis le Portal d'un compte donné.
• Le compte qui détient la clé peut la régénérer : le serveur doit alors recevoir la nouvelle valeur pour continuer à s'authentifier.

Pour une équipe, créez donc les clés depuis le compte du ou de la responsable du projet, celui qui paie les scripts et l'abonnement, plutôt que depuis le compte personnel d'un membre du staff susceptible de partir. Protégez ce compte comme un accès d'administration : mot de passe unique et double authentification.

Créer la clé de licence dans le Portal, étape par étape

1. Connectez-vous sur portal.cfx.re avec le compte Cfx.re retenu.
2. Ouvrez la rubrique Servers, puis la page des clés d'enregistrement. L'adresse directe est portal.cfx.re/servers/registration-keys : c'est elle que vise le lien « Server license keys » de la page d'hébergement officielle de fivem.net.
3. Lancez la création d'une nouvelle clé et remplissez la fiche du serveur. D'après le centre d'aide de Cfx.re, quatre champs sont obligatoires avant de pouvoir générer la clé : le nom (Name), une accroche courte (Tagline), la description (Description) et la langue (Language).
4. Ajoutez les éléments de présentation si vous les avez sous la main : jusqu'à cinq tags, une bannière, une image de profil et un lien d'invitation Discord. Ils peuvent aussi se compléter plus tard.
5. Cliquez sur Generate Key. La page qui s'affiche permet de copier la clé d'enregistrement ; c'est aussi depuis la fiche du serveur que vous pourrez la régénérer plus tard.

Prenez le nom au sérieux : depuis le 21 octobre 2026, c'est lui qu'affiche la liste des serveurs, et non plus une ligne de server.cfg. Pour un serveur de test, choisissez un nom qui le distingue clairement de la production, afin de ne jamais coller la mauvaise clé au mauvais endroit.

Placer la clé dans server.cfg sur un VPS ou un serveur dédié

Sur un VPS Linux, un VPS Windows ou un serveur dédié où vous lancez FXServer vous-même, la clé se place dans server.cfg, le fichier de configuration du répertoire de données du serveur (server-data dans la documentation officielle). Le fichier d'exemple fourni par Cfx.re contient déjà la ligne sv_licenseKey changeme : remplacez changeme par votre clé, entre guillemets.

# Clé d'enregistrement du serveur, créée sur https://portal.cfx.re
sv_licenseKey "collez-ici-la-cle-copiee-dans-le-portal"

Le serveur doit ensuite être lancé depuis ce répertoire, avec l'argument +exec server.cfg sur la ligne de commande, sans quoi le fichier n'est jamais lu et la clé non plus. La méthode change selon le système.

Sur un VPS Linux (Debian, Ubuntu) : en SSH

La documentation de FXServer n'impose pas de distribution Linux : elle demande le paquet xz-utils (ou xz) pour décompresser l'artifact, et Git en option pour récupérer cfx-server-data. Sur Debian comme sur Ubuntu, la clé se modifie donc en ligne de commande, connecté en SSH avec le compte qui fait tourner le serveur, et non avec root :

# Connexion au serveur (utilisateur et adresse IP à adapter)
ssh fivem@203.0.113.10

# Ouvrir le fichier de configuration (nano ou l'éditeur de votre choix)
nano ~/FXServer/server-data/server.cfg

# Relancer FXServer depuis le répertoire server-data
cd ~/FXServer/server-data && bash ~/FXServer/server/run.sh +exec server.cfg

Réservez sudo aux tâches système (mises à jour, pare-feu, installation de paquets) : FXServer n'a besoin d'aucun droit root pour lire sa clé, et un serveur de jeu lancé en root donne tout le système au premier script compromis. Si vous administrez depuis un PC sous Windows, notre guide pour accéder à un VPS Linux avec PuTTY et WinSCP montre comment ouvrir la session SSH et éditer server.cfg en SFTP.

Sous Windows (VPS Windows ou serveur dédié)

Sous Windows, ouvrez la session Bureau à distance du serveur, modifiez C:\FXServer\server-data\server.cfg avec le Bloc-notes ou un éditeur de code, puis relancez FXServer depuis l'invite de commandes (cmd.exe). L'option /d de cd ne sert que si vous changez de lecteur :

cd /d C:\FXServer\server-data
C:\FXServer\server\FXServer.exe +exec server.cfg

La documentation de Cfx.re présente la version Linux de FXServer comme un portage proposé par courtoisie, Windows restant la plateforme la mieux prise en charge : c'est l'une des raisons de choisir un VPS Windows pour un serveur FiveM. La clé, elle, est identique sur les deux systèmes.

Si FXServer tourne en service systemd

Quand FXServer démarre comme service systemd, deux directives décident si la clé est lue : WorkingDirectory, qui doit pointer vers le répertoire server-data, et ExecStart, qui doit passer +exec server.cfg. Une erreur sur l'une des deux, et la console affiche « no license key was specified » alors que la clé est bien dans le fichier.

[Service]
User=fivem
WorkingDirectory=/home/fivem/FXServer/server-data
ExecStart=/bin/bash /home/fivem/FXServer/server/run.sh +exec server.cfg

Après un changement de clé, un sudo systemctl restart suivi du nom de votre service suffit. Notre guide pour créer un service systemd pour un serveur de jeu détaille le reste de l'unité.

Sortir la clé et les autres secrets du fichier principal

Si vous versionnez votre configuration dans Git, sortez la clé du fichier principal. Placez la ligne sv_licenseKey dans un fichier séparé, par exemple secrets.cfg, ajoutez exec secrets.cfg dans server.cfg, et excluez secrets.cfg du dépôt avec .gitignore. Le centre d'aide de Cfx.re consacre un article entier aux clés publiées par erreur sur GitHub : mieux vaut ne jamais en arriver là.

Le même fichier accueille l'autre secret classique d'un serveur FiveM : la chaîne de connexion à la base de données MySQL ou MariaDB, que la ressource oxmysql lit dans la convar mysql_connection_string. Sa documentation demande de la définir avant de démarrer les ressources : la ligne exec secrets.cfg se place donc avant celle qui lance oxmysql.

# server.cfg
exec secrets.cfg
ensure oxmysql

# secrets.cfg (jamais commité)
sv_licenseKey "collez-ici-la-cle-copiee-dans-le-portal"
set mysql_connection_string "mysql://fivem:mot-de-passe@localhost:3306/fivem"

Sur Linux, limitez la lecture de ce fichier au compte du serveur avec chmod 600 ~/FXServer/server-data/secrets.cfg. Les exemples d'oxmysql se connectent avec l'utilisateur root de MySQL : préférez un utilisateur réservé à la base du serveur, comme l'explique notre guide pour lier une base de données MySQL à un serveur FiveM.

Coller la clé dans le panel ou dans txAdmin

Chez un hébergeur de serveurs de jeu, la clé ne se saisit généralement pas dans server.cfg mais dans les variables de démarrage du panel, qui la transmettent à FXServer au lancement. Sur un panel Pterodactyl, elles se trouvent dans l'onglet Startup. Avec l'egg FiveM communautaire (dépôt pelican-eggs), la variable s'appelle « fivem license » (FIVEM_LICENSE) et le serveur ne peut pas démarrer sans elle. Sur nos offres serveur FiveM, sous Pterodactyl, la clé se colle dans la variable de démarrage prévue à cet effet et reste en place si vous réinstallez le serveur depuis le panel.

Pour modifier server.cfg lui-même sur une offre mutualisée sous Pterodactyl, pas besoin de SSH : le gestionnaire de fichiers du panneau de contrôle (onglet Files) ouvre le fichier dans le navigateur, et un client FTP comme FileZilla ou WinSCP s'y connecte en SFTP avec les identifiants affichés dans l'onglet Settings. Avant toute modification, créez une sauvegarde depuis l'onglet Backups : notre guide sur les sauvegardes Pterodactyl explique comment la restaurer.

Avec txAdmin, deux cas se présentent :

• Nouveau serveur : dans le Recipe Deployer, txAdmin demande la clé avant de lancer la recette (bouton Run Recipe). Il l'écrit lui-même dans le server.cfg qu'il génère, à l'emplacement réservé de la recette.
• Serveur existant : l'éditeur de server.cfg intégré à txAdmin permet de modifier la ligne sv_licenseKey, puis de redémarrer le serveur depuis l'interface. Notre guide pour configurer txAdmin sur un serveur FiveM détaille le reste de l'outil.

Le tableau suivant résume où se trouve la clé selon le type d'hébergement.

Serveur RedM : la même clé, un réglage en plus

Le Portal gère indifféremment les serveurs FiveM et RedM : même compte, même page des clés d'enregistrement, même fiche à remplir. La différence se joue côté FXServer : pour héberger un serveur RedM, la documentation officielle demande d'ajouter set gamename rdr3 dans server.cfg. Dans l'egg communautaire de Pterodactyl, c'est la variable de jeu (TXHOST_GAME_NAME) qui passe de fivem à redm. Pour le reste de l'installation, suivez notre guide pour héberger un serveur RedM de zéro à en ligne, ou partez d'une offre serveur RedM déjà configurée.

Une clé par serveur, trois clés actives par compte

Chaque instance de FXServer a besoin de sa propre clé. Cfx.re limite par ailleurs chaque compte à trois clés actives : la règle date d'octobre 2020, du temps de Keymaster, et visait la revente de clés. Le forum prévoit une demande d'exception pour qui justifie d'un besoin réel de plus de trois serveurs en ligne simultanément. En pratique, trois clés couvrent la plupart des configurations : la production, un serveur de test et un serveur d'événement ou de développement.

Et la clé « déjà utilisée » ? Cfx.re ne documente pas de message d'erreur spécifique quand une même clé sert à deux machines. Le cas réel est presque toujours le même : une clé copiée d'un serveur à l'autre (production clonée pour un test, ancien hébergeur encore actif pendant une migration). La correction ne change pas : une clé par instance, et une nouvelle clé pour toute machine qui n'en a pas.

Changer d'hébergeur ou d'adresse IP

La clé appartient à votre compte Cfx.re, pas à l'hébergeur : elle vous suit. Elle n'est pas pour autant totalement indépendante de l'adresse IP. Du temps de Keymaster, le formulaire demandait l'IP du serveur, et FXServer peut refuser une clé présentée depuis une autre adresse avec ce message :

Could not authenticate server license key. Your key is not matching the initial IP address sufficiently (#1, IP requested is 203.0.113.10). Please create a new key, or run the server on [...]

La procédure du Portal décrite par le centre d'aide ne demande plus d'adresse IP, mais le message de la console indique lui-même la marche à suivre. Lors d'un changement d'hébergeur ou d'IP :

1. Démarrez le nouveau serveur avec la clé actuelle et lisez la console.
2. Si l'IP est refusée, régénérez la clé depuis la fiche du serveur dans le Portal, ou créez-en une nouvelle, puis remplacez la valeur dans server.cfg ou dans la variable de démarrage du panel avant de redémarrer.
3. Même si la clé est acceptée, régénérez-la une fois la migration terminée si l'ancien hébergeur ou un ancien administrateur y avait accès : l'ancienne valeur ne servira plus à personne.
4. Gardez le même compte Cfx.re, sinon vos scripts sous escrow refuseront de démarrer.

Le reste de la migration (backup du répertoire server-data, export de la base de données MySQL, txData, nom de domaine) est couvert par notre guide pour migrer son serveur FiveM d'un hébergeur à l'autre. Pensez à reprendre secrets.cfg s'il existe : il ne figure dans aucun dépôt Git, il faut donc le copier à part. Pour que vos joueurs n'aient plus à retenir une adresse IP qui change, faites pointer un nom de domaine avec un enregistrement SRV vers le serveur : seule la zone DNS change lors d'un déménagement.

OneSync, limite de 48 slots et abonnement Element Club

La clé gratuite suffit à un serveur jusqu'à 48 joueurs. La FAQ de la page d'hébergement de fivem.net l'écrit en toutes lettres : par défaut, un serveur accepte jusqu'à 48 joueurs avec OneSync Infinity. Au-delà, la documentation de dépannage de Cfx.re est tout aussi claire : plus de 48 slots demandent un abonnement Element Club Argentum ou supérieur.

OneSync est la couche réseau de Cfx.re construite par-dessus le code réseau d'origine du jeu, et OneSync Infinity son extension pour les grands serveurs. Le lien avec le nombre de joueurs passe par sv_maxclients, qui accepte une valeur de 1 à 2048 : à partir de 32, il faut onesync réglé sur on ou legacy, et au-delà de 64, obligatoirement sur on. Le server.cfg d'exemple de Cfx.re contient d'ailleurs set onesync on et sv_maxclients 48.

Prix et paliers relevés sur la page server-hosting de fivem.net le 11 novembre 2026 : vérifiez-les dans le Portal avant de souscrire. Pour passer au-delà de 48 joueurs :

1. Souscrivez l'abonnement depuis la rubrique Subscriptions du Portal, avec le compte qui possède la clé du serveur.
2. Utilisez l'artifact FXServer le plus récent (notre guide sur les gamebuild et artifacts FiveM explique comment le mettre à jour).
3. Réglez sv_maxclients au-dessus de 48, dans la limite de votre palier, et vérifiez la valeur de onesync.
4. Redémarrez le serveur. Cfx.re prévient que l'activation des avantages peut prendre jusqu'à six heures.

Deux limites à ne pas confondre avec celle de Cfx.re. D'abord, la capacité de l'hébergement : 64 ou 128 joueurs simultanés demandent un processeur rapide par cœur et assez de RAM pour les ressources chargées, quel que soit le palier payé (voir notre guide pour optimiser les performances d'un serveur FiveM). Ensuite, le panel : dans l'egg FiveM communautaire de Pterodactyl, la variable du nombre de joueurs est bornée de 1 à 48. Au-delà, l'hébergeur doit relever cette borne : demandez-le au support avant de payer l'abonnement.

La fiche du serveur dans le Portal et la liste publique

Depuis le 21 octobre 2026, la présentation du serveur dans la liste de FiveM et de RedM vient de sa fiche dans le Portal. La documentation des commandes serveur l'acte : sv_hostname, sets sv_projectName et sets sv_projectDesc sont dépréciés, avec pour consigne d'utiliser le Portal à la place. Modifier ces lignes dans server.cfg ne change donc plus ce que voient les joueurs.

• Données reprises : Cfx.re a recopié dans le Portal les informations historiques qu'il a pu retrouver. Pour les autres serveurs, les champs sont restés vides, et la liste affiche alors « Missing server data (must be configured in Portal) ».
• Tags : cinq au maximum. Un serveur qui en avait davantage n'affiche que les cinq premiers, par ordre chronologique.
• Visuels : bannière recommandée en 2560 × 280 pixels (1825 × 200 au minimum), image de profil en 512 × 512 pixels (256 × 256 au minimum).
• Discord : le lien d'invitation s'affiche dans la rubrique Details du client, sous le nom d'utilisateur du propriétaire du serveur.

Erreurs fréquentes liées à la clé et leur correction

Si le serveur s'arrête avant même d'atteindre l'authentification de la clé, le problème est ailleurs : notre guide FiveM ne se lance pas et la liste des solutions aux erreurs courantes sur FiveM couvrent les autres causes.

Serveur absent de la liste des serveurs

Une clé valide ne garantit pas que le serveur apparaisse dans la liste publique. La documentation de Cfx.re donne un ordre de vérification simple :

1. Patientez : sans autre signal envoyé par le serveur, il peut falloir jusqu'à 8 minutes après le démarrage pour qu'il apparaisse dans la liste.
2. Vérifiez sv_master1 : dans server.cfg, la ligne #sv_master1 "" doit rester commentée. Sans le #, vous désactivez la publication dans la liste : le serveur passe en privé et ne se rejoint plus depuis la liste.
3. Testez la connexion directe : dans la console F8 du client, tapez connect IP:port avec l'IP publique du serveur. Ouvrez aussi http://IP:30120/info.json dans un navigateur : ce fichier est servi par le serveur web intégré à FXServer, et une réponse JSON prouve que le serveur est joignable depuis l'extérieur.
4. Contrôlez les ports : si la connexion directe échoue, c'est en général le pare-feu (firewall) du système ou une redirection de port. Le port 30120 doit être ouvert en TCP et en UDP (voir notre guide pour ouvrir les ports d'un serveur de jeu avec UFW).
5. Relisez la fiche du Portal : un serveur affiché avec « Missing server data » est bien en ligne, mais sa présentation est vide.

Protéger la clé comme un mot de passe

Une clé qui circule permet à n'importe qui de faire tourner un serveur à votre nom, et de consommer l'une de vos trois places. Quelques règles simples :

• Ne publiez jamais server.cfg ou un fichier contenant la clé dans un dépôt Git public : utilisez un fichier séparé exclu du dépôt, comme vu plus haut.
• Floutez la ligne sv_licenseKey et l'onglet de démarrage du panel avant de partager une capture d'écran sur Discord.
• Ne transmettez pas la clé aux auteurs de scripts : une ressource n'a aucune raison de la demander.
• Limitez l'accès SSH, SFTP et txAdmin aux administrateurs qui en ont réellement besoin : chacun d'eux peut lire la clé.
• Au moindre doute (fuite, départ d'un administrateur, ancien hébergeur), régénérez la clé et mettez à jour server.cfg ou le panel dans la foulée.

Les ressources gratuites de provenance douteuse sont l'autre porte d'entrée classique sur un serveur : notre guide sur les scripts FiveM à éviter aide à faire le tri.

Checklist de la clé de licence

• Compte Cfx.re du ou de la responsable du projet, protégé par la double authentification.
• Une clé créée par serveur sur portal.cfx.re, avec un nom explicite (production, test).
• Fiche du serveur complète : nom, accroche, description, langue, puis tags, visuels et lien Discord.
• Clé collée dans server.cfg (sv_licenseKey), dans la variable de démarrage du panel ou dans le Recipe Deployer de txAdmin, à un seul endroit.
• Serveur lancé avec +exec server.cfg depuis le bon répertoire (en SSH, sous Windows ou via systemd), set gamename rdr3 en plus pour RedM.
• Clé et chaîne de connexion MySQL dans un secrets.cfg lisible par le seul compte du serveur, jamais en root.
• Au-delà de 48 joueurs : Element Club Argentum ou plus sur le même compte, sv_maxclients relevé, OneSync sur on.
• Après un changement d'hébergeur ou d'IP : clé régénérée si la console la refuse ou si l'ancien hébergeur la connaissait.
• Clé absente de tout dépôt Git public et de toute capture d'écran.

Vous partez de zéro ? Notre guide de mise en place d'un serveur FiveM reprend l'installation complète, et nos serveurs FiveM arrivent avec Pterodactyl, txAdmin et l'anti-DDoS déjà en place : il ne reste qu'à coller la clé créée sur le Portal.