Offre de lancement — -20% sur tous les VPS avec le code NVH20 · Déploiement en 60 secondes
Accueil / Blog / Erreurs de démarrage FiveM
FiveM

Serveur FiveM qui ne démarre pas : les erreurs fréquentes et leurs solutions

Par Équipe NVHCloud 20 septembre 2026 Lecture : 9 min

Un serveur FiveM qui refuse de démarrer donne toujours une explication : elle est dans les vingt premières lignes du journal. Encore faut-il savoir où regarder et comment traduire les messages. Voici les cas que notre support voit le plus souvent, et ce qu'ils signifient.

1. Lire le bon journal

Trois endroits, selon votre installation :

journalctl -u fivem -n 80 --no-pager    # serveur lancé par systemd
tmux attach -t fivem                     # serveur lancé dans tmux
# txAdmin : onglet Live Console

Cherchez la première erreur, pas la dernière : les suivantes en découlent souvent. Une erreur signalée en rouge ou précédée de ^1 dans la console est bloquante ; un avertissement ne l'est pas.

2. Problèmes de licence

MessageCause et solution
Invalid license keyLa clé est mal recopiée, ou entre guillemets manquants dans sv_licenseKey. Regénérez-la sur portal.cfx.re si besoin.
License key does not match server IPLa clé est liée à une autre adresse IP. Modifiez l'adresse associée dans le portail Cfx.re, ou créez une nouvelle clé pour ce serveur.
Your license key has been bannedLa clé a été suspendue, en général pour violation des conditions d'utilisation. Contactez Cfx.re : personne d'autre ne peut la rétablir.
Could not contact Cfx.reLe serveur n'a pas accès à Internet en sortie. Vérifiez la résolution DNS et le pare-feu sortant.

Une clé de licence est gratuite et propre à un serveur. Ne la partagez pas et ne la publiez jamais dans une capture d'écran de votre configuration.

3. Port occupé, joueurs éjectés

Address already in use : un autre processus écoute déjà sur le port, presque toujours une instance précédente mal arrêtée.

ss -tulpn | grep 30120
systemctl stop fivem      # ou kill du processus restant

Les joueurs se connectent puis sont immédiatement déconnectés, avec un message de délai dépassé : dans neuf cas sur dix, le port est ouvert en TCP mais pas en UDP. FiveM a besoin des deux.

ufw allow 30120 comment 'FiveM TCP et UDP'
ufw status | grep 30120

Vérifiez aussi que votre server.cfg contient bien les deux lignes d'écoute, et que le serveur écoute sur toutes les interfaces :

endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"

Notre générateur de server.cfg les inclut toujours toutes les deux.

4. Ressources en échec

  • Couldn't find resource X : le nom dans ensure ne correspond pas au nom du dossier. Attention aux majuscules : Linux distingue esx_menu_default de ESX_Menu_Default, contrairement à Windows. C'est la cause numéro un lors d'une migration depuis un serveur Windows.
  • Failed to load script suivi d'une erreur de syntaxe : le script est incompatible avec votre build, ou corrompu lors du transfert. Voir quel build d'artefacts choisir.
  • Unable to find dependency : une ressource en exige une autre, démarrée avant elle. L'ordre des lignes ensure compte : oxmysql et le framework d'abord, le reste ensuite.
  • Une ressource démarre puis s'arrête seule : lisez les lignes juste avant, l'erreur réelle y figure presque toujours.

Pour isoler un coupable, commentez la moitié de vos ensure, redémarrez, puis dichotomie : en trois ou quatre essais, vous tenez la ressource fautive.

5. Base de données

[oxmysql] Connection refused ou Access denied for user : la chaîne de connexion est fausse, ou MariaDB n'est pas démarrée.

systemctl status mariadb
mariadb -u utilisateur -p nom_base -e "SELECT 1;"

Si cette commande fonctionne mais pas le serveur, comparez caractère par caractère la chaîne de connexion du server.cfg. Les erreurs classiques : un mot de passe contenant un caractère spécial non encodé, ou localhost attendu alors que le serveur tourne dans un conteneur. Détails dans sécuriser MariaDB.

6. Le serveur démarre mais n'apparaît pas dans la liste

  • Vérifiez que sv_master1 n'a pas été mis à vide dans une configuration récupérée ailleurs : cela retire volontairement le serveur de la liste publique.
  • Assurez-vous que le port est bien joignable depuis l'extérieur, et pas seulement en local.
  • Patientez quelques minutes après le démarrage complet : l'indexation n'est pas instantanée.
  • En attendant, vos joueurs peuvent toujours rejoindre directement avec la commande connect adresse:30120 dans la console F8.

7. La checklist quand plus rien ne marche

  1. Lire la première erreur du journal, pas la dernière.
  2. Démarrer avec un server.cfg minimal, sans aucune ressource ajoutée : si ça démarre, le problème vient de vos ressources.
  3. Vérifier la licence, puis les deux lignes d'écoute TCP et UDP.
  4. Réactiver les ressources par moitiés jusqu'à isoler la fautive.
  5. Vérifier l'espace disque avec df -h : un disque plein provoque des erreurs incompréhensibles.
  6. En dernier recours, repartir d'une installation propre avec txAdmin, puis réimporter vos ressources une par une.
Gardez une copie qui fonctionne

Avant chaque ajout de ressource ou changement de build, copiez le dossier du serveur et exportez la base. Revenir en arrière prend alors trente secondes, au lieu d'une soirée entière.

La procédure d'installation complète est dans notre guide installer un serveur FiveM sur un VPS, et les problèmes de performance sont traités dans serveur FiveM qui lag : trouver la vraie cause.

À lire ensuite

Questions fréquentes

Pourquoi mes joueurs sont-ils déconnectés juste après s'être connectés ?
Presque toujours parce que le port est ouvert en TCP mais pas en UDP. FiveM a besoin des deux, et votre server.cfg doit contenir les lignes endpoint_add_tcp et endpoint_add_udp. Vérifiez aussi que la clé de licence correspond bien à l'adresse IP du serveur.
Que signifie « Couldn't find resource » au démarrage ?
Le nom écrit après ensure ne correspond pas exactement au nom du dossier de la ressource. Sous Linux, les majuscules comptent, contrairement à Windows : c'est l'erreur la plus fréquente après une migration depuis un serveur Windows.
Ma clé de licence est refusée, que faire ?
Vérifiez qu'elle est bien recopiée entre guillemets, puis que l'adresse IP associée dans le portail Cfx.re est celle de votre serveur. Si vous avez changé de machine, mettez l'adresse à jour ou créez une nouvelle clé.
Comment savoir quelle ressource empêche le démarrage ?
Démarrez avec un server.cfg minimal, sans ressource ajoutée. Si le serveur démarre, réactivez vos ressources par moitiés : en trois ou quatre redémarrages, vous isolez la coupable.
Mon serveur démarre mais n'apparaît pas dans la liste publique, pourquoi ?
Vérifiez que le port est joignable depuis l'extérieur, que sv_master1 n'a pas été vidé dans votre configuration, et patientez quelques minutes après le démarrage. Vos joueurs peuvent entre-temps se connecter directement avec la commande connect suivie de l'adresse et du port.