Dépannage

Une erreur de sv_licenseKey veut dire que FXServer n’a pas pu faire valider sa clé d’enregistrement par Cfx.re : il ne l’a pas trouvée, Cfx.re l’a refusée, ou la vérification n’a pas abouti. Le plus souvent, le server.cfg qui contient la clé n’est pas lu, ou la clé a été mal copiée. Lisez les lignes qui suivent « Authenticating server license key... » dans la console, puis comparez la clé avec celle du portail portal.cfx.re.

Mise à jour : 15 novembre 2026

Les messages, et ce qu’ils veulent dire

Un démarrage normal affiche ces deux lignes :

Authenticating server license key...
Server license key authentication succeeded. Welcome!

Un échec prend l’une de ces formes :

Clé absente
This server does not have a license key specified. FXServer n’a lu aucune clé. Le message continue avec l’adresse du portail et un exemple de ligne set sv_licenseKey.
Clé refusée
Could not authenticate server license key. Une clé a bien été lue, mais Cfx.re ne la reconnaît pas. Une précision renvoyée par Cfx.re suit parfois.
Vérification impossible
An error occurred while checking server license key: suivi de la cause technique. Could not resolve host désigne un problème de DNS sur la machine, HTTP 429 un excès de tentatives.
Trop de places
Côté joueur, à la connexion : This server uses more slots than allowed by the current subscription. Le serveur a démarré, mais son sv_maxclients dépasse ce que permet le compte de la clé.
Ressource refusée
You lack the required entitlement to use suivi d’un nom de ressource. La clé est valide, mais elle n’appartient pas au compte qui a acheté cette ressource protégée.

Les causes, de la plus fréquente à la plus rare

  • Le server.cfg n’est pas lu. Le serveur a été lancé depuis le mauvais dossier, ou sans +exec server.cfg, et la console l’annonce par No such config file: server.cfg. Sous txAdmin, le fichier que vous avez modifié n’est pas celui que txAdmin charge.
  • La valeur d’exemple est restée : les configurations de départ contiennent sv_licenseKey changeme.
  • La clé a été mal copiée : un espace en trop, des guillemets typographiques collés depuis un message, un caractère manquant, ou une ligne commentée par #. Une clé récente commence par cfxk_.
  • La clé n’existe plus : supprimée ou remplacée sur le portail, ou créée sur un autre compte que celui que vous consultez.
  • Le nombre de places dépasse l’abonnement. Sans abonnement Element Club, la limite est de 48.
  • La machine ne joint pas Cfx.re : DNS en panne, pare-feu qui bloque le HTTPS sortant, trop de redémarrages rapprochés, ou incident chez Cfx.re.
  • Une ressource payante a été achetée sur un autre compte que celui de la clé.

Corriger, cause par cause

Clé absente
Ouvrez le server.cfg réellement utilisé et vérifiez la ligne sv_licenseKey "cfxk_…". Sans txAdmin, lancez FXServer depuis le dossier de données, avec +exec server.cfg. Sous txAdmin, contrôlez Server Data Folder et CFG File Path dans Settings, onglet FXServer.
Clé refusée
Sur portal.cfx.re, ouvrez la partie Servers et la liste des clés d’enregistrement. Copiez la clé depuis le portail, pas depuis un ancien message, et collez-la entre guillemets droits, sans espace. Si elle n’apparaît plus, générez-en une nouvelle : un nom suffit. Remplacez l’ancienne et redémarrez.
Vérification impossible
Depuis la machine du serveur, lancez curl -I https://portal-api.cfx.re : une réponse HTTP, même une erreur 404, prouve que le DNS et le HTTPS sortant fonctionnent. Sur un HTTP 429, coupez le serveur au lieu de le laisser se relancer en boucle, et attendez avant de réessayer. Si rien n’a changé chez vous, une panne chez Cfx.re reste possible : patientez avant de régénérer quoi que ce soit.
Trop de places
Ramenez sv_maxclients à 48, ou prenez un abonnement Element Club sur le compte qui possède la clé. Le palier Aurum ne donne 128 places qu’avec OneSync réglé sur « on », pas sur « legacy », et le message d’erreur le précise. Les paliers et leurs limites sont résumés dans notre guide pour créer un serveur FiveM RP.
Ressource refusée
Utilisez une clé créée sur le compte qui a acheté la ressource, puis redémarrez FXServer.

Dans tous les cas, la clé est vérifiée au lancement de FXServer. Après un changement, redémarrez le serveur en entier, depuis txAdmin ou en relançant le processus. Changer la valeur en console ou redémarrer une ressource ne relance pas la vérification.

Voici la forme attendue, avec la clé rangée dans un fichier à part que le server.cfg charge :

# server.cfg
exec secrets.cfg

# secrets.cfg, jamais publié ni partagé
sv_licenseKey "cfxk_votre_cle"

Vérifier que c’est réglé

  • La console affiche Server license key authentication succeeded. Welcome! à chaque démarrage.
  • Le serveur apparaît dans la liste des serveurs FiveM, sauf si vous l’en avez retiré volontairement.
  • Un joueur se connecte sans message sur les places, même quand sv_maxclients dépasse 48.
  • Les ressources payantes démarrent sans You lack the required entitlement.

Éviter que ça revienne

  • Une clé par serveur : une pour le serveur ouvert, une pour le test. Vous en remplacez une sans toucher à l’autre.
  • La clé dans un fichier à part, déclarée avec sv_licenseKey ou set, jamais avec sets, qui la publierait dans la liste des serveurs.
  • Achats et abonnement sur le même compte que la clé.
  • Le renouvellement de l’abonnement surveillé. Le contrôle des places porte sur sv_maxclients, pas sur le nombre de joueurs présents : si l’abonnement tombe, plus personne n’entre tant que la valeur dépasse 48.
  • Des artifacts à jour : sur les versions anciennes, les messages d’erreur de licence sont moins précis.

Ce qu’on a vu en production sur un grand serveur RP français : des jetons d’accès collés dans un salon Discord, ou poussés dans un dépôt git. Chaque fois, la seule réponse sûre a été de les régénérer sur-le-champ. Pour une clé de serveur, cela veut dire en générer une nouvelle sur le portail, l’installer, redémarrer, puis supprimer l’ancienne.

La checklist pour ouvrir un serveur RP reprend ces contrôles avant le jour de l’ouverture. Si vous préférez confier l’hébergement et la configuration du serveur, GeoBase propose une base RP hébergée, réglable sans coder.

Questions fréquentes

Où trouver sa clé de licence FiveM ?
Sur le portail Cfx.re, portal.cfx.re, dans la partie Servers, rubrique des clés d’enregistrement. « License key » et « registration key » désignent la même clé.
La clé de licence FiveM est-elle payante ?
Non. La clé est gratuite et suffit jusqu’à 48 places. Au-delà, il faut un abonnement Element Club sur le même compte.
Faut-il redémarrer après avoir changé sv_licenseKey ?
Oui, FXServer en entier. La clé est vérifiée au lancement du processus : la changer en console ou redémarrer une ressource ne suffit pas.
Pourquoi mes joueurs voient-ils « more slots than allowed » ?
Le sv_maxclients du serveur dépasse ce que permet l’abonnement du compte de la clé, soit 48 places sans abonnement. Baissez la valeur, ou prenez le palier adapté sur ce même compte.

À lire ensuite