NVHCloud
English
Español
Türkçe
Русский
Deutsch
États-Unis
Canada
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.
Si le serveur démarre bien mais devient injoignable par moments, pensez aussi à une attaque réseau : voyez notre protection Anti-DDoS pour FiveM.
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 ConsoleCherchez 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
| Message | Cause et solution |
|---|---|
Invalid license key | La 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 IP | La 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 banned | La 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.re | Le 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 30120Vé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 dansensurene correspond pas au nom du dossier. Attention aux majuscules : Linux distingueesx_menu_defaultdeESX_Menu_Default, contrairement à Windows. C'est la cause numéro un lors d'une migration depuis un serveur Windows.Failed to load scriptsuivi 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 lignesensurecompte :oxmysqlet 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_master1n'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:30120dans la console F8.
7. La checklist quand plus rien ne marche
- Lire la première erreur du journal, pas la dernière.
- Démarrer avec un
server.cfgminimal, sans aucune ressource ajoutée : si ça démarre, le problème vient de vos ressources. - Vérifier la licence, puis les deux lignes d'écoute TCP et UDP.
- Réactiver les ressources par moitiés jusqu'à isoler la fautive.
- Vérifier l'espace disque avec
df -h: un disque plein provoque des erreurs incompréhensibles. - En dernier recours, repartir d'une installation propre avec txAdmin, puis réimporter vos ressources une par une.
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
Serveur FiveM qui lag : trouver la cause
Diagnostiquer un serveur FiveM qui rame : lire resmon, repérer la ressource fautive et savoir si le problème vient des scripts ou de la machine.
FiveM : quel build d'artefacts choisir ?
Comprendre les artefacts FXServer : build recommandé ou dernier build, comment changer de version sans casser son serveur, et le rôle de…
Installer un serveur FiveM sur un VPS : le guide complet
Guide pas à pas pour installer un serveur FiveM sur un VPS Linux : préparation, artefacts, clé Cfx.re, server.cfg, txAdmin, base MariaDB, service systemd,…
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.