LibraHostDocumentation

Documentation

Guides complets pour tous nos services d'hébergement

Toutes les documentations

Navigation

🎮 Installer un serveur FiveM sur VPS Linux#

Créez votre propre serveur FiveM pour GTA V sur un VPS Debian ou Ubuntu. Ce guide couvre l'installation complète avec txAdmin pour gérer facilement votre serveur roleplay.

🎯 Objectif#

  • Préparer le VPS pour FiveM
  • Installer les artefacts FiveM (fx server)
  • Configurer txAdmin pour la gestion du serveur
  • Ouvrir les ports nécessaires
  • Lancer et maintenir le serveur

🧰 Prérequis#

  • Un VPS sous Debian 11/12 ou Ubuntu 20.04/22.04/24.04
  • Minimum 2 vCPU, 4 Go RAM, 30 Go SSD
  • Accès root ou sudo
  • Une clé de licence CFX (gratuite sur Cfx.re Keymaster)
  • Connexion SSH

1️⃣ Mise à jour du système#

sudo apt update && sudo apt upgrade -y
sudo apt autoremove --purge -y

2️⃣ Installer les dépendances#

🔹 Paquets nécessaires#

sudo apt install -y wget curl tar xz-utils screen git nano

🔹 Créer un utilisateur dédié#

⚠️ Important : Ne jamais exécuter FiveM en root pour des raisons de sécurité.

sudo adduser fivem
sudo usermod -aG sudo fivem

Basculez sur cet utilisateur :

su - fivem

3️⃣ Télécharger les artefacts FiveM#

🔹 Créer le répertoire d'installation#

mkdir -p ~/fxserver/server
cd ~/fxserver/server

🔹 Télécharger la dernière version#

Récupérez le lien des derniers artefacts sur runtime.fivem.net puis :

wget https://runtime.fivem.net/artifacts/fivem/build_proot_linux/master/XXXX-XXXXXXXXX/fx.tar.xz

💡 Astuce : Remplacez XXXX-XXXXXXXXX par le numéro de build le plus récent (recommandé : dernière version stable).

🔹 Extraire les fichiers#

tar -xvf fx.tar.xz
rm fx.tar.xz

4️⃣ Obtenir une clé de licence CFX#

  1. Rendez-vous sur Cfx.re Keymaster
  2. Connectez-vous avec votre compte Cfx.re (ou créez-en un)
  3. Cliquez sur « Register a new server »
  4. Remplissez les informations :
    • Label : Nom de votre serveur
    • Server IP Address : L'IP de votre VPS
    • Server Type : VPS / Dedicated Server
  5. Cliquez sur « Generate »
  6. Copiez la clé générée (format : cfxk_xxxxxxxxxxxxxxxxxxxx_xxxxx)

⚠️ Important : Gardez cette clé secrète. Ne la partagez jamais publiquement.

5️⃣ Premier lancement et configuration txAdmin#

🔹 Lancer le serveur pour la première fois#

⚠️ Important : Au premier lancement, ne pas utiliser +exec server.cfg car le fichier n'existe pas encore. txAdmin va nous guider pour le créer.

cd ~/fxserver/server
screen -S fivem

Une fois dans le screen, lancez le serveur :

./run.sh

Vous devriez voir apparaître quelque chose comme :

         ████████████████████████████████
         █████████████████████████████████████

         txAdmin v7.x.x starting...

         Use the PIN below to register:
         ========================
              1234
         ========================

         Admin URL: http://0.0.0.0:40120/

💡 Note : Notez bien le PIN à 4 chiffres affiché, vous en aurez besoin pour configurer txAdmin.

🔹 Se détacher du screen#

Appuyez sur Ctrl + A puis D pour détacher le screen (le serveur continue de tourner en arrière-plan).

🔹 Accéder à txAdmin#

  1. Ouvrez votre navigateur et allez sur :
http://IP_DE_VOTRE_VPS:40120

  1. Entrez le PIN affiché dans le terminal

  2. Créez votre compte administrateur txAdmin (nom d'utilisateur + mot de passe)

  3. Suivez l'assistant de configuration :

    Étape 1 - Backup : Ignorez ou configurez selon vos besoins

    Étape 2 - Server Name : Donnez un nom à votre serveur

    Étape 3 - Deploy Type : Choisissez "Popular Recipes" puis sélectionnez un template :

    • CFX Default : Serveur basique vanilla
    • QBCore : Framework RP populaire
    • ESX Legacy : Autre framework RP populaire

    Étape 4 - Data Location : Définissez le chemin :

    /home/fivem/fxserver/server-data

    Étape 5 - License Key : Collez votre clé de licence CFX (obtenue à l'étape 4 du guide)

    Étape 6 - Review & Save : Vérifiez et validez

  4. txAdmin va télécharger les ressources et créer le server.cfg automatiquement

  5. Une fois terminé, cliquez sur "Start Server" dans txAdmin

🔹 Commandes screen utiles#

CommandeDescription
screen -S fivemCréer un nouveau screen nommé "fivem"
Ctrl + A puis DDétacher le screen (serveur continue)
screen -r fivemReprendre le screen
screen -lsLister les screens actifs
exit ou Ctrl + DFermer le screen (⚠️ arrête le serveur)

🔹 En cas de problème avec screen#

Si screen se ferme immédiatement, lancez directement sans screen pour voir les erreurs :

./run.sh

Lisez les messages d'erreur affichés, puis corrigez le problème avant de relancer avec screen.

6️⃣ Configuration du server.cfg#

Le fichier server.cfg se trouve dans votre dossier server-data. Voici les paramètres essentiels :

nano ~/fxserver/server-data/server.cfg

🔹 Paramètres de base#

# Nom et description du serveur
sv_hostname "Mon Serveur FiveM - LibraHost"
sv_projectDesc "Serveur Roleplay GTA V"
sv_projectName "MonServeur"

# Clé de licence (générée sur Keymaster)
sv_licenseKey "cfxk_xxxxxxxxxxxxxxxxxxxx_xxxxx"

# Nombre maximum de joueurs
sv_maxclients 32

# Activer OneSync (recommandé)
set onesync on

# Endpoint du serveur
endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"

# RCON (optionnel - pour administration distante)
rcon_password "MotDePasseTresSecurise123!"

# Tags pour la liste des serveurs (optionnel)
sets tags "roleplay, francais, custom"

# Langue
sets locale "fr-FR"

🔹 Ressources essentielles#

# Ressources de base
ensure mapmanager
ensure chat
ensure spawnmanager
ensure sessionmanager
ensure basic-gamemode
ensure hardcap

7️⃣ Lancement automatique au démarrage (optionnel)#

💡 Note : Cette méthode remplace l'utilisation de screen. Choisissez soit screen (étape 5), soit systemd (cette étape), mais pas les deux en même temps.

🔹 Créer un service systemd#

sudo nano /etc/systemd/system/fivem.service

Collez le contenu suivant :

[Unit]
Description=FiveM Server
After=network.target

[Service]
Type=simple
User=fivem
WorkingDirectory=/home/fivem/fxserver/server
ExecStart=/home/fivem/fxserver/server/run.sh
Restart=on-failure
RestartSec=10

[Install]
WantedBy=multi-user.target

🔹 Activer le service#

sudo systemctl daemon-reload
sudo systemctl enable fivem
sudo systemctl start fivem

🔹 Commandes de gestion#

CommandeDescription
sudo systemctl start fivemDémarrer le serveur
sudo systemctl stop fivemArrêter le serveur
sudo systemctl restart fivemRedémarrer le serveur
sudo systemctl status fivemVoir le statut
journalctl -u fivem -fVoir les logs en direct

8️⃣ Ajouter des ressources#

🔹 Structure des dossiers#

~/fxserver/
├── server/          # Artefacts FiveM
└── server-data/     # Données du serveur
    ├── resources/   # Vos scripts et mods
    ├── server.cfg   # Configuration
    └── cache/       # Cache du serveur

🔹 Installer une ressource#

  1. Téléchargez la ressource (GitHub, forums CFX, etc.)
  2. Placez-la dans le dossier resources :
cd ~/fxserver/server-data/resources
git clone https://github.com/exemple/ma-resource.git
  1. Ajoutez-la au server.cfg :
ensure ma-resource
  1. Redémarrez le serveur ou utilisez txAdmin

9️⃣ FAQ & problèmes courants#

  • Impossible d'accéder à txAdmin ? Vérifiez que vous utilisez bien http://IP:40120 (pas https). Assurez-vous que le serveur est bien lancé.

  • Les joueurs ne peuvent pas se connecter ? Assurez-vous que la clé de licence est valide et associée à la bonne IP sur Cfx.re Keymaster.

  • Erreur "Could not find server.cfg" ? C'est normal au premier lancement. Suivez l'assistant txAdmin qui va créer le fichier automatiquement.

  • Screen se ferme immédiatement ? Lancez ./run.sh sans screen pour voir les erreurs. Vérifiez que vous êtes bien dans le dossier /home/fivem/fxserver/server.

  • Le serveur crash au démarrage ? Vérifiez les logs avec journalctl -u fivem -f (si systemd) ou dans le screen. Souvent dû à une ressource mal configurée.

  • Serveur non visible dans la liste ? Ajoutez sv_master1 "" dans server.cfg si vous voulez rester invisible, ou vérifiez vos paramètres sets.

  • Performance lente / lag ? Activez OneSync avec set onesync on. Vérifiez que votre VPS a assez de RAM (minimum 4 Go recommandé).

  • Comment mettre à jour les artefacts ? Arrêtez le serveur, téléchargez les nouveaux artefacts dans ~/fxserver/server, extrayez-les, puis redémarrez.

  • Screen ou systemd ? Utilisez screen pour les tests et le développement (plus flexible). Utilisez systemd pour la production (redémarrage automatique).

✅ Conclusion#

Votre serveur FiveM est maintenant installé et opérationnel sur votre VPS LibraHost. Utilisez txAdmin pour gérer facilement les joueurs, les ressources et les paramètres. N'oubliez pas de faire des sauvegardes régulières de votre dossier server-data.

Contacter le support