Obtenir et configurer sa clé Cfx.re

Un serveur FiveM a besoin d’une clé serveur délivrée par Cfx.re, l’éditeur de FiveM. Sans elle, le serveur démarre mais refuse les joueurs et n’apparaît dans aucune liste. Cette page explique comment l’obtenir, où la mettre, et quoi faire quand elle est refusée.

La clé est gratuite et ne vient pas de CloudFive : elle appartient à votre compte Cfx.re. CloudFive héberge le serveur, Cfx.re délivre la licence — personne ne peut vous la fournir à votre place.

Une clé par serveur

Deux serveurs qui tournent en même temps avec la même clé se font déconnecter l’un l’autre, et la clé finit par être bloquée. Si vous avez un serveur de production et un serveur de test, créez deux clés.

Créer une clé sur le Keymaster

Le Keymaster est le portail de Cfx.re qui gère les clés serveur. On y accède avec son compte Cfx.re — le même que celui du forum officiel et du client FiveM.

1. Créez un compte Cfx.re si vous n’en avez pas, puis ouvrez le Keymaster, l’espace des clés serveur de votre compte Cfx.re.

2. Lancez la création d’une nouvelle clé serveur.

3. Choisissez le type de serveur : FiveM pour GTA V, RedM pour Red Dead Redemption 2. Le type ne se change pas après coup.

4. Renseignez un libellé qui vous parle : « RP principal », « test ». Vous aurez peut-être cinq clés dans un an, et elles se ressemblent toutes.

5. Renseignez l’adresse IP de votre serveur (section suivante).

6. Validez, puis copiez la clé affichée. Collez-la tout de suite dans un gestionnaire de mots de passe ou un fichier privé.

Danger

Votre clé serveur est un secret, au même titre qu’un mot de passe. Quelqu’un qui la possède peut faire tourner un serveur à votre nom et faire bloquer la vôtre. Ne la publiez jamais sur un dépôt Git, un Discord, un pastebin, et masquez-la sur vos captures de console.

Renseigner l’adresse IP du serveur

Le Keymaster demande l’adresse IP du serveur qui utilisera la clé. C’est l’adresse IP publique de votre serveur CloudFive, pas celle de votre PC.

1. Ouvrez la fiche de votre serveur sur panel.cloudfive.xyz. L’adresse et le port de votre serveur y sont affichés.

2. Relevez l’adresse IP seule, sans le port. Si le panel affiche 203.0.113.10:30120, l’IP est 203.0.113.10.

3. Reportez-la dans le champ d’adresse du Keymaster.

Note

Ne saisissez pas une adresse en 127.0.0.1, ni une adresse privée en 192.168.x.x ou 10.x.x.x : ce sont des adresses locales, elles ne désignent pas votre serveur sur Internet.

Si l’adresse IP de votre serveur change un jour — migration, changement d’offre, réinstallation sur une autre machine — pensez à mettre à jour la clé dans le Keymaster, ou à en créer une nouvelle. Une clé renseignée avec l’adresse d’un serveur que vous n’avez plus est la première chose à vérifier quand un serveur qui marchait hier ne démarre plus.

Pour retrouver l’adresse et le port exacts de votre serveur : Ports et allocations.

Ajouter la clé dans server.cfg

La clé se déclare avec la directive sv_licenseKey, dans le server.cfg à la racine des fichiers de votre serveur.

1. Ouvrez le gestionnaire de fichiers du panel, ou connectez-vous en SFTP.

2. Éditez server.cfg.

3. Ajoutez la ligne suivante, en remplaçant la valeur par votre clé :

   server.cfg

   sv_licenseKey "cle-de-test"
   sv_licenseKey "VOTRE_CLE_CFX"

4. Vérifiez qu’il n’y a qu’une seule ligne sv_licenseKey dans tout le fichier. Si la clé est déclarée deux fois, c’est la dernière qui gagne — et c’est rarement celle que vous croyez.

5. Enregistrez, puis redémarrez le serveur depuis le panel. Voir Démarrer, arrêter et redémarrer son serveur.

6. Surveillez la console au démarrage : la clé est validée dans les premières secondes.

Collez, ne retapez pas

Une clé Cfx.re est une longue suite de caractères sans signification. Un 0 pris pour un O, un espace invisible collé en fin de ligne, et la clé est refusée sans autre explication. Copiez-collez systématiquement, puis relisez le début et la fin de la ligne.

Si vous administrez votre serveur avec txAdmin, inclus dans les offres FiveM, l’interface propose aussi un champ pour la clé serveur. Renseignez-la à un seul endroit : soit le server.cfg, soit txAdmin. Voir Prendre en main txAdmin.

Régénérer une clé compromise

Régénérez votre clé dès que l’un de ces cas se présente :

• elle est apparue dans une capture d’écran, un message public ou un dépôt Git ;
• un ancien membre de l’équipe y a eu accès ;
• vous avez confié vos fichiers à un développeur externe ;
• Cfx.re signale un usage simultané que vous ne reconnaissez pas.

1. Dans le Keymaster, ouvrez la clé concernée et révoquez-la ou supprimez-la.

2. Créez une nouvelle clé avec la même adresse IP et un libellé clair.

3. Remplacez la valeur de sv_licenseKey dans votre server.cfg.

4. Redémarrez le serveur et vérifiez la console.

Danger

Dès que l’ancienne clé est révoquée, le serveur qui l’utilise encore est refusé au démarrage suivant. Prévoyez la manipulation en dehors des heures de jeu : entre la révocation et le redémarrage avec la nouvelle clé, votre serveur est injoignable.

Profitez-en pour limiter les accès à vos fichiers plutôt que de partager votre compte : le panel permet de créer des sous-utilisateurs avec des droits restreints.

Erreurs fréquentes : clé invalide, heartbeat manquant

« Invalid license key » au démarrage. La clé n’est pas acceptée. Dans l’ordre :

1. Comparez caractère par caractère la clé du Keymaster et celle du server.cfg.
2. Vérifiez les guillemets : la valeur doit être entourée de guillemets droits ", pas de guillemets typographiques « ou ” recopiés depuis un document.
3. Vérifiez que la clé n’a pas été révoquée dans le Keymaster.
4. Vérifiez le type : une clé RedM ne fait pas tourner un serveur FiveM.
5. Vérifiez qu’aucun autre serveur ne tourne avec la même clé.

« Couldn’t register server on the server list » ou aucun heartbeat. Le serveur fonctionne — la connexion directe marche — mais il ne s’enregistre pas auprès de Cfx.re, donc il n’apparaît pas dans la liste publique. Les causes, de la plus fréquente à la plus rare :

• la clé est invalide ou révoquée : traitez d’abord le point précédent ;
• la même clé est utilisée ailleurs ;
• l’enregistrement a simplement besoin de quelques minutes après un démarrage ;
• l’enregistrement est refusé côté Cfx.re, indépendamment de votre configuration.

Ce dernier cas est trompeur : la console affiche une erreur de clé alors que la clé est correcte. Si vous avez vérifié les points ci-dessus et que la connexion directe fonctionne, n’allez pas régénérer trois clés de suite — ouvrez un ticket de support en joignant les lignes exactes de la console. C’est de notre côté que ça se vérifie.

Si ça ne marche pas

Vous avez perdu la clé. Elle ne se réaffiche pas en clair. Créez-en une nouvelle et remplacez-la dans le server.cfg : c’est plus rapide que de chercher.

Vous avez supprimé la bonne clé par erreur. Créez-en une autre. Une clé n’a aucune valeur en elle-même : rien n’est perdu, ni les joueurs, ni les données.

Le serveur boucle : démarrage, erreur de clé, arrêt. Arrêtez-le depuis le panel avant de corriger le fichier. Éditer un server.cfg pendant qu’un serveur redémarre en boucle fait perdre la modification.

Vous hébergez deux serveurs sur la même offre. Ce n’est pas la bonne approche : chaque serveur veut son propre service, ses propres ressources et sa propre clé. Pour un second serveur de test, voir le catalogue sur cloudfive.fr/fivem — l’offre d’entrée est à 2,50 €/mois, sans engagement.

Rien de tout cela ne correspond. Les questions les plus courantes sont rassemblées dans la FAQ, et le support est joignable 7 j/7 : Contacter le support.