Clé Keymaster FiveM : créer son compte CFX.re et générer sa licence

Sans clé de licence Keymaster, votre serveur FiveM ne sera pas visible publiquement et ne pourra pas accueillir de joueurs. Cette clé est délivrée gratuitement par CFX.re (l'éditeur de FiveM) et doit être associée à votre serveur lors de la configuration. Ce guide détaille la procédure complète : création du compte, génération de la clé et intégration dans votre panel Pterodactyl Lordhosting.

⚙️ Prérequis

Une offre d'hébergement FiveM Lordhosting active
Accès à votre panel Pterodactyl
Une adresse email valide pour créer le compte CFX.re

⚙️ 1. Créer un compte CFX.re

Rendez-vous sur le portail Keymaster :

https://keymaster.fivem.net

Cliquez sur « Register » en haut à droite. Vous serez redirigé vers le forum CFX.re, qui sert d'identité unique pour tous les services FiveM (Keymaster, Tebex, Server List, etc.).

Renseignez :

Un email valide (utilisé pour la confirmation et la récupération de compte)
Un nom d'utilisateur unique
Un mot de passe sécurisé

Confirmez votre adresse email via le lien reçu, puis reconnectez-vous sur Keymaster.

💡 Important : utilisez un compte personnel sérieux. Si votre compte est suspendu par CFX.re (en cas de violation du code de conduite), toutes vos clés de licence sont révoquées.

⚙️ 2. Récupérer l'IP de votre serveur Lordhosting

Avant de générer la clé, notez l'IP publique de votre serveur FiveM Lordhosting :

Connectez-vous à votre panel Pterodactyl Lordhosting
Cliquez sur votre serveur FiveM dans la liste
Sur le Dashboard du serveur, l'IP du serveur est affichée en haut (format xxx.xxx.xxx.xxx:30120)

L'IP de nos serveurs FiveM est statique : elle ne change pas tant que vous gardez votre offre active. Vous pouvez donc utiliser le mode « locked to IP » sur Keymaster en toute sécurité.

⚙️ 3. Générer la clé de licence

Sur keymaster.fivem.net, une fois connecté :

Cliquez sur « New » (ou « Register » selon les versions)
Choisissez le serveur cible :
- Server type : FXServer (par défaut)
- IP Address : collez l'IP publique récupérée à l'étape 2 (sans le port)
Sélectionnez le mode de licence :
- Locked to IP (recommandé pour les offres Lordhosting) : la clé ne fonctionne que sur cette IP. Plus sécurisé.
- No IP restriction (Master) : la clé fonctionne partout. À choisir uniquement si vous prévoyez de changer d'hébergeur souvent.
Validez. Votre clé apparaît sous la forme :

cfxk_XXXXXXXXXXXXXXXXXXXXXXXXX_YYYYYY

Copiez-la et conservez-la en lieu sûr. Elle ne sera plus affichée en clair par la suite (sauf via régénération).

⚙️ 4. Enregistrer la clé sur votre serveur Pterodactyl

Vous avez deux méthodes pour intégrer la clé à votre serveur Lordhosting :

Méthode A — Via l'onglet Startup (recommandée)

Dans votre panel Pterodactyl, sélectionnez votre serveur FiveM
Onglet « Startup » (dans le menu de gauche)
Trouvez la variable LICENSE_KEY (ou SV_LICENSE_KEY selon l'œuf)
Collez votre clé dans le champ
Cliquez sur « Save »

Cette méthode est la plus propre : la clé reste isolée du fichier server.cfg, donc moins de risque d'exposer la clé en cas de partage de configuration.

Méthode B — Directement dans server.cfg

Dans votre panel Pterodactyl, ouvrez le File Manager
Éditez le fichier server.cfg (à la racine de votre serveur)
Ajoutez ou modifiez la ligne :

sv_licenseKey "cfxk_XXXXXXXXXXXXXXXXXXXXXXXXX_YYYYYY"

Sauvegardez le fichier

⚠️ Ne committez jamais votre server.cfg avec la clé en clair dans un dépôt Git public. Préférez toujours la méthode A si vous versionnez votre configuration.

⚙️ 5. Démarrer le serveur

Retournez sur l'onglet « Console » de votre serveur Pterodactyl et cliquez sur « Start ».

Si la clé est valide, vous verrez apparaître dans les logs :

Authenticated with Cfx.re Nucleus
Server is up

Si vous voyez une erreur du type License key authentication failed, vérifiez :

Que la clé est complète (préfixe cfxk_ inclus)
Que l'IP utilisée pour générer la clé correspond bien à celle de votre serveur Lordhosting
Qu'aucun espace n'a été ajouté avant ou après la clé lors du copier-coller

⚙️ 6. Vérifier la visibilité de votre serveur

Une fois le serveur démarré, il devrait apparaître dans la server list FiveM publique sous quelques minutes. Pour vérifier :

https://servers.fivem.net

Recherchez le nom de votre serveur (défini par sv_hostname dans server.cfg). S'il n'apparaît pas après 10 minutes :

Vérifiez que les ports FiveM sont bien exposés (Pterodactyl s'en charge automatiquement chez Lordhosting)
Vérifiez les logs côté console pour repérer une éventuelle erreur de configuration

⚙️ Que faire si vous changez d'offre ou de serveur ?

Si vous migrez vers une autre offre Lordhosting (ou changez d'hébergeur), l'IP de votre serveur change. Vous devrez alors :

Retourner sur keymaster.fivem.net
Supprimer l'ancienne clé (ou la regénérer avec la nouvelle IP)
Créer une nouvelle clé liée à la nouvelle IP
La remplacer dans votre panel Pterodactyl (méthode A ou B)

C'est gratuit et illimité côté Keymaster.

⚙️ Pour aller plus loin

Le fichier server.cfg de A à Z : personnalisez l'identité de votre serveur (nom, slots, tags, bannière)
ESX vs QBCore : quel framework choisir ? : le choix qui structure votre futur serveur RP
Mettre à jour son serveur FiveM : maintenir vos artifacts à jour