Intermédiaire ⏱ 12 min Mis à jour le 29 juillet 2026

Réparer un serveur FiveM qui ne démarre pas ou qui crash

Serveur FiveM qui refuse de démarrer ou qui plante en boucle ? Pas de panique. La console vous dit toujours pourquoi. Voici la méthode pour diagnostiquer et réparer.

Votre serveur FiveM ne démarre pas : commencez par la console

Lorsqu’un serveur FiveM ne démarre pas, la console contient généralement l’information nécessaire pour identifier la cause. L’erreur importante n’est pas forcément la dernière ligne affichée : recherchez plutôt le premier message d’erreur exploitable, car les lignes suivantes peuvent n’être que ses conséquences.

Depuis txAdmin, ouvrez la console en direct, puis redémarrez FXServer afin d’observer le lancement depuis le début. Pour prendre en main cette interface, consultez le guide pour démarrer avec txAdmin.

Recherchez notamment les messages contenant :

SCRIPT ERROR
Couldn't start resource
Couldn't find dependency
No such export
Access denied for user
Unknown database
Failed to load
License key

Notez le nom de la ressource affichée entre crochets. Par exemple :

[script:garage_entreprise] SCRIPT ERROR: ...

Le problème vient probablement de garage_entreprise ou d’une dépendance qu’il utilise.

Appliquez cette méthode de diagnostic :

  1. redémarrez le serveur ;
  2. relevez la première erreur ;
  3. identifiez la ressource concernée ;
  4. vérifiez sa documentation et ses dépendances ;
  5. corrigez un seul élément ;
  6. redémarrez et contrôlez le résultat.

Ne modifiez pas simultanément les artifacts, la base de données et plusieurs scripts. Vous ne sauriez plus quelle modification a corrigé ou aggravé le problème.

Avant toute intervention, des sauvegardes automatiques sont incluses pour vous aider à restaurer. Conservez aussi vos propres exports réguliers : vous restez responsable de vos données.

Erreur : une dépendance est manquante

De nombreux scripts dépendent d’une bibliothèque, d’un connecteur SQL ou d’un framework. Si cette ressource est absente ou démarre trop tard, FXServer peut refuser de charger le script.

Messages fréquents :

Couldn't find dependency ox_lib for resource mon_script
No such export MySQL in resource oxmysql
Couldn't find resource es_extended
No such export GetCoreObject in resource qb-core

Vérifiez d’abord que chaque dépendance se trouve dans resources/ et contient directement un fichier fxmanifest.lua.

Exemple correct :

resources/
├── [standalone]/
│   ├── oxmysql/
│   │   └── fxmanifest.lua
│   └── ox_lib/
│       └── fxmanifest.lua
└── [local]/
    └── mon_script/
        └── fxmanifest.lua

Contrôlez ensuite l’ordre des lignes dans server.cfg. Les dépendances doivent démarrer avant les scripts qui les utilisent.

Pour ESX :

ensure oxmysql
ensure ox_lib
ensure es_extended

ensure mon_script

Pour QBCore :

ensure oxmysql
ensure ox_lib
ensure qb-core

ensure mon_script

Une erreur de dépendance peut aussi venir d’un mauvais nom de dossier. Si le script recherche ox_lib, le dossier ne doit pas être renommé ox_lib-main ou ox_lib-v3.

Erreur : la version des artifacts est incompatible

Certains scripts exigent une version minimale de FXServer. Si vos artifacts sont trop anciens, la ressource peut utiliser une fonction indisponible ou refuser de démarrer.

Vous pouvez rencontrer des messages comme :

This resource requires a newer server artifact
Failed to load script
No such native
This server artifact is outdated

Relevez le numéro de build affiché au démarrage, puis comparez-le aux prérequis indiqués par le développeur du script. Pour la procédure complète, consultez le guide pour mettre à jour les artifacts FXServer.

Dans le panel TalCloud :

  1. arrêtez le serveur ;
  2. notez le numéro d’artifact actuel ;
  3. créez une sauvegarde ;
  4. sélectionnez de préférence le canal recommandé ;
  5. mettez à jour FXServer ;
  6. redémarrez et testez les ressources.

Ne choisissez pas automatiquement le build le plus récent sur votre serveur principal. Une version recommandée est généralement préférable en production, sauf lorsqu’un script ou un correctif exige explicitement un build plus récent.

Si le crash apparaît juste après une mise à jour, revenez temporairement à l’ancien numéro d’artifact. Vous pourrez ensuite mettre à jour les scripts incompatibles avant de retenter la migration.

Erreur : la licence Cfx.re est invalide

FXServer doit disposer d’une clé Cfx.re valide dans server.cfg.

La directive attendue est :

sv_licenseKey "cfxk_VOTRE_CLE"

Une clé absente ou incorrecte peut produire un message proche de :

This server does not have a license key specified

Vérifiez :

  • que la ligne n’est pas précédée de # ;
  • que la clé est complète ;
  • que les guillemets sont fermés ;
  • que FXServer charge le bon server.cfg ;
  • que la clé est toujours active dans le portail Cfx.re ;
  • qu’elle correspond à votre serveur et à votre compte.

Exemple incorrect :

# sv_licenseKey "cfxk_VOTRE_CLE"

Le caractère # transforme la ligne en commentaire. La clé n’est donc pas chargée.

Exemple correct :

sv_licenseKey "cfxk_VOTRE_CLE"

Ne publiez jamais votre clé Cfx.re dans une capture, un dépôt GitHub ou un message Discord. Si elle a été exposée, révoquez-la et générez-en une nouvelle. Pour tout savoir sur sa gestion, consultez le guide sur la licence Cfx.re.

Erreur : oxmysql ne se connecte pas

ESX, QBCore et de nombreux scripts RP dépendent d’une base MySQL. Si oxmysql ne peut pas s’y connecter, le framework peut démarrer partiellement, produire une succession d’erreurs ou rester inutilisable.

Messages fréquents :

Access denied for user
Unknown database
Unable to establish a connection
Table 'nom_base.users' doesn't exist

Vérifiez la chaîne de connexion placée avant ensure oxmysql :

set mysql_connection_string "mysql://UTILISATEUR:MOT_DE_PASSE@HOTE:3306/NOM_BASE?charset=utf8mb4"

ensure oxmysql

Chaque erreur oriente vers une cause précise :

MessageCause probable
Access denied for userUtilisateur, mot de passe ou autorisation incorrecte
Unknown databaseNom de base erroné ou base inexistante
Unable to establish a connectionHôte, port, identifiants ou service MySQL indisponible
Table ... doesn't existFichier SQL non importé ou mauvaise base sélectionnée
No such export ... oxmysqlOxmysql absent, mal installé ou démarré trop tard

Si le mot de passe contient des caractères réservés comme @, :, / ou #, utilisez leur encodage dans l’URL ou la syntaxe par paramètres :

set mysql_connection_string "user=fivem_user;password=MotDePasse;host=mysql.exemple.fr;port=3306;database=fivem"

Ne publiez jamais cette ligne avec de véritables identifiants. Pour une configuration détaillée, consultez le guide oxmysql et la base de données.

Erreur : un script fait crash le serveur

Lorsqu’un crash commence après l’installation ou la mise à jour d’une ressource, désactivez-la temporairement dans server.cfg.

Configuration active :

ensure nouveau_script

Configuration désactivée :

# ensure nouveau_script

Redémarrez ensuite le serveur. S’il fonctionne à nouveau, vous avez isolé le problème.

Lorsque plusieurs scripts ont été ajoutés simultanément, utilisez une méthode par élimination :

  1. désactivez la moitié des nouveaux scripts ;
  2. redémarrez ;
  3. observez si l’erreur persiste ;
  4. continuez avec le groupe fautif ;
  5. répétez jusqu’à identifier la ressource précise.

Vérifiez ensuite :

  • sa compatibilité ESX, QBCore ou standalone ;
  • ses dépendances ;
  • son fichier SQL ;
  • sa version minimale de FXServer ;
  • les modifications demandées dans server.cfg ;
  • son fichier de configuration.

Évitez de supprimer directement les fichiers. Les commenter dans server.cfg facilite le retour arrière.

Erreur : server.cfg est mal écrit

Une faute de syntaxe peut empêcher une directive ou une ressource de fonctionner correctement.

Erreurs courantes :

ensur mon_script
ensure "mon script"
sv_licenseKey "cfxk_CLE
set mysql_connection_string mysql://user:pass@host/base

Utilisez des noms de ressources sans espaces :

ensure mon_script

Fermez toujours les guillemets :

sv_licenseKey "cfxk_VOTRE_CLE"

Placez les valeurs sensibles ou contenant des caractères spéciaux entre guillemets :

set mysql_connection_string "mysql://user:pass@host:3306/base"

Vérifiez également que le fichier chargé au démarrage est bien le bon :

+exec server.cfg

Dans txAdmin, contrôlez le chemin du profil et le fichier de configuration associé. Une modification peut être correcte mais sans effet si FXServer exécute un autre server.cfg.

En résumé

  • Lorsqu’un serveur FiveM ne démarre pas, recherchez la première erreur exploitable dans la console txAdmin.
  • Notez le nom de la ressource concernée avant de modifier la configuration.
  • Vérifiez les dépendances et leur ordre dans server.cfg.
  • Démarrez oxmysql, ox_lib et le framework avant leurs scripts dépendants.
  • Mettez à jour les artifacts lorsqu’une ressource exige un build plus récent.
  • Revenez à l’ancien build si le crash commence juste après une mise à jour.
  • Vérifiez la ligne sv_licenseKey et gardez votre clé Cfx.re privée.
  • Contrôlez la connection string oxmysql, le nom de la base et les tables SQL.
  • Désactivez les scripts par groupes pour identifier une ressource fautive.
  • Vérifiez les fautes dans server.cfg, les guillemets et les lignes ensure.
  • Corrigez un seul élément à la fois, puis redémarrez pour valider.
  • Pour réparer et administrer votre serveur FiveM depuis un panel de gestion avec stockage NVMe, Anti-DDoS L3/L4/L7 inclus et support francophone, consultez l’offre serveur FiveM TalCloud.