Espace client
Keymaster FiveM : guide complet
Chaque serveur FiveM a besoin d'une clé de licence pour fonctionner. Sans elle, le serveur refuse de démarrer. Le keymaster fivem (aussi écrit key master fivem) est le portail officiel de Cfx.re où vous générez, gérez et surveillez cette clé. Ce guide couvre la création de compte, la génération de clé, la gestion des licences et la configuration sur OuiPanel en 2026, étape par étape.
Qu'est-ce que Keymaster ?
Keymaster est le portail de gestion des clés serveur opéré par Cfx.re, les créateurs de FiveM. Accessible à l'adresse keymaster.fivem.net, il centralise plusieurs fonctions essentielles pour les propriétaires de serveurs.
La clé de licence (license key) est un identifiant unique qui authentifie votre serveur auprès du réseau FiveM. Elle permet aux joueurs de trouver et rejoindre votre serveur via la liste FiveM. Chaque serveur nécessite sa propre clé : utiliser la même clé sur deux serveurs simultanés provoque des conflits d'authentification et peut entrainer un blocage.
Le portail Keymaster FiveM regroupe trois sections principales. La section Servers liste toutes vos clés enregistrées avec leur nom, IP associée et date de création. La section Asset Grants recense les ressources (scripts, véhicules, maps) achetées sur le store officiel Cfx.re/Tebex et liées à votre compte. La section Subscription gère votre abonnement Cfx.re (anciennement Patreon), qui débloque des avantages comme OneSync Infinity, des bannières personnalisées et des limites de clés plus élevées.
La clé de licence est gratuite, sans expiration et sans limite de durée. Les comptes gratuits peuvent créer plusieurs clés, mais il existe un plafond. Si vous atteignez cette limite, supprimez les clés inutilisées ou souscrivez un abonnement Cfx.re pour un quota supérieur.
Créer un compte Keymaster
Avant de générer une clé, vous devez posséder un compte Cfx.re. Voici la marche à suivre.
1. Rendez-vous sur forum.cfx.re et cliquez sur "Sign Up" en haut à droite. Remplissez le formulaire : nom d'utilisateur, adresse email valide et mot de passe.
2. Consultez votre boite de réception et cliquez sur le lien de confirmation envoyé par Cfx.re. Vérifiez les dossiers spam/promotions si le mail n'apparait pas dans la boite principale. Sans confirmation, le compte reste inactif.
3. Une fois le compte confirmé, connectez-vous sur keymaster.fivem.net avec les mêmes identifiants. Le portail Keymaster utilise l'authentification du forum Cfx.re : un seul compte pour les deux.
Conseil : utilisez une adresse email à laquelle vous avez un accès permanent. C'est cette adresse qui sert à la récupération de compte et aux notifications importantes (changements de politique, alertes de sécurité).
Obtenir une clé serveur FiveM
Depuis le portail keymaster fivem, la génération d'une clé prend moins de deux minutes.
1. Cliquez sur "New Server" dans le menu de navigation en haut de la page.
2. Remplissez le formulaire avec les informations suivantes :
-
Display Name : le nom d'identification de votre serveur. Ce nom est visible uniquement dans votre dashboard Keymaster (pas dans la liste FiveM publique). Choisissez un nom parlant si vous gérez plusieurs serveurs, par exemple "RP Principal" ou "Serveur Test".
-
Initial Server IP Address : l'adresse IP publique de votre serveur. Ne pas inclure le port (pas de
:30120à la fin). Si vous êtes hébergé chez OuiHeberg, l'IP est affichée dans OuiPanel sur la page principale de votre serveur. Pour trouver l'IP d'un VPS ou d'une machine personnelle, consultez un site comme whatismyipaddress.com. -
Server Type : sélectionnez "VPS" dans le menu déroulant si vous utilisez un hébergeur (OuiHeberg, VPS ou dédié). Sélectionnez "Other / Home hosted" uniquement si le serveur tourne sur votre propre machine.
-
Which server provider are you using? : ce champ est informatif et n'a aucun impact technique. Indiquez "OuiHeberg" ou tout autre texte.
3. Cliquez sur "Generate". Votre clé apparait immédiatement à l'écran sous la forme d'une longue chaine de caractères alphanumériques (exemple : cfxk_xxxxxxxxxxxxxxxxxxxx_xxxxxx).
4. Copiez la clé immédiatement et conservez-la dans un endroit sécurisé. Vous pourrez toujours la retrouver dans votre dashboard Keymaster, mais il est préférable de ne pas dépendre uniquement du portail.
⚠️ Ne partagez jamais votre clé publiquement. Toute personne possédant votre clé pourrait l'utiliser sur un autre serveur, ce qui provoquerait un conflit avec le vôtre. Si vous soupçonnez une fuite, utilisez l'option "Re-Activate" dans Keymaster pour régénérer la clé sans créer un nouvel enregistrement.
Gérer et transférer sa licence
Le dashboard Keymaster FiveM offre plusieurs options de gestion pour vos clés existantes.
Modifier l'IP associée. Si votre serveur change d'adresse IP (migration d'hébergeur, changement d'offre), vous devez mettre à jour l'IP dans Keymaster. Accédez à la clé concernée dans la section "Servers", modifiez le champ IP et enregistrez. Le changement est immédiat.
Réactiver une clé (Re-Activate). Si votre serveur refuse de démarrer avec l'erreur "License key is not valid" ou "License key already in use", utilisez le bouton "Re-Activate" sur la clé concernée. Cette action régénère la clé tout en conservant le même enregistrement serveur. Utile en cas de fuite de clé ou de conflit.
Supprimer un enregistrement. Si vous ne gérez plus un serveur, supprimez l'enregistrement pour libérer un slot dans votre quota de clés. La suppression est définitive.
Assets et ressources Tebex. Les scripts et véhicules achetés sur le store officiel sont liés à votre compte Cfx.re. La section "Asset Grants" affiche toutes vos ressources. Le transfert d'assets vers un autre compte est possible dans certains cas (vérifiez l'éligibilité dans la section dédiée), mais les clés serveur elles-mêmes ne sont pas transférables entre comptes. Si vous vendez un projet RP, le nouveau propriétaire devra générer sa propre clé.
Abonnement Cfx.re. Les abonnements (anciennement gérés via Patreon, désormais sur le portail Cfx.re) débloquent OneSync Infinity (jusqu'à 2 048 joueurs), la personnalisation du bandeau serveur, des limites de clés plus élevées et le support prioritaire. L'abonnement est facultatif : un serveur gratuit fonctionne parfaitement avec OneSync standard (jusqu'à 64 joueurs par défaut, 128 avec certaines configurations).
Configurer la clé sur OuiPanel
Une fois votre clé générée sur le portail keymaster fivem, il faut l'injecter dans la configuration de votre serveur. Sur un hébergement serveur FiveM OuiHeberg, deux méthodes sont disponibles.
Méthode 1 : via le champ OuiPanel (recommandée).
- Connectez-vous à dash.ouipanel.com et sélectionnez votre serveur FiveM.
- Allez dans Configuration (menu latéral gauche).
- Repérez le champ "FIVEM LICENSE" (ou "License Key").
- Collez votre clé Keymaster dans ce champ.
- Appuyez sur Entrée pour sauvegarder.
- Redémarrez votre serveur pour appliquer le changement.
Méthode 2 : via server.cfg (avancée).
- Dans OuiPanel, ouvrez le Gestionnaire de fichiers.
- Naviguez jusqu'au fichier server.cfg à la racine de votre serveur.
- Cliquez sur "Modifier" pour ouvrir l'éditeur.
- Localisez la ligne
sv_licenseKeyet remplacez la valeur existante par votre clé :
sv_licenseKey "cfxk_xxxxxxxxxxxxxxxxxxxx_xxxxxx"
- Enregistrez le fichier et redémarrez le serveur.
Si votre serveur démarre correctement et apparait dans la liste des serveurs FiveM, la clé est validée. En cas d'erreur, vérifiez que la clé est correctement copiée (sans espace avant/après), que l'IP dans Keymaster correspond à l'IP de votre serveur OuiHeberg, et que la clé n'est pas utilisée sur un autre serveur.
Une fois la licence en place, vous pouvez mettre à jour l'artefact FiveM pour profiter des dernières fonctionnalités, puis configurer votre configuration SQL FiveM avec oxmysql pour connecter votre base de données.
FAQ Keymaster
La clé Keymaster est-elle payante ?
Non. La génération de clés serveur sur keymaster.fivem.net est entièrement gratuite. Seuls les abonnements Cfx.re (pour OneSync Infinity et les avantages supplémentaires) sont payants.
Peut-on utiliser la même clé sur deux serveurs ?
Non. Chaque serveur FiveM doit avoir sa propre clé unique. Utiliser une clé sur deux serveurs simultanément provoque une erreur d'authentification et empêche les joueurs de se connecter.
Ma clé ne fonctionne pas, que faire ?
Vérifiez trois points dans cet ordre : la clé est bien copiée sans espace ni caractère en trop, l'IP dans Keymaster correspond exactement à l'IP publique de votre serveur (sans le port), et la clé n'est pas déjà active sur un autre serveur. Si le problème persiste, utilisez "Re-Activate" dans Keymaster pour régénérer la clé.
Les clés expirent-elles ?
Non. Les clés serveur FiveM standard n'ont pas de date d'expiration. Elles restent valides tant que votre compte Cfx.re existe et que la clé n'est pas supprimée manuellement.
Combien de clés peut-on créer avec un compte gratuit ?
Le nombre exact varie, mais les comptes gratuits disposent d'un quota limité (généralement suffisant pour 2-3 serveurs). Si vous gérez plus de serveurs, supprimez les clés inutilisées ou optez pour un abonnement Cfx.re qui augmente le quota.
Comment transférer un serveur FiveM à quelqu'un d'autre ?
Les clés ne se transfèrent pas entre comptes. Le nouveau propriétaire doit créer son propre compte Cfx.re, générer une nouvelle clé et la configurer dans son server.cfg. Les assets achetés sur Tebex peuvent parfois être transférés via la section "Asset Grants" du portail.
Besoin d'un serveur GTA/FiveM ?
Découvrez nos offres d'hébergement GTA V / FiveM dès 9,98€/mois avec déploiement instantané.