FR

Serveurs de jeux

Comment mettre à jour les artifacts FXServer

Mettez à jour FXServer et txAdmin sur votre serveur FiveM Linux : contrôle de la version, sauvegarde, installation d'une build recommandée ou précise, vérification et retour arrière.

5 min de lecture, mis à jour le 18 novembre 2026

Sur cette page

Les artifacts sont les fichiers du serveur FiveM publiés par Cfx.re : FXServer et la version de txAdmin qu'il embarque. Ce guide vous explique comment les mettre à jour proprement, en gardant la version précédente pour pouvoir revenir en arrière en quelques commandes.

Prérequis

  • Un serveur installé avec le guide Créer un serveur FiveM, dont le script /home/fivem/update-fxserver.sh et le script de sauvegarde /usr/local/sbin/backup-fivem.sh
  • Un accès SSH avec sudo
  • Un moment sans joueurs : le serveur est arrêté pendant l'opération

Ce guide concerne FiveM pour GTA V Legacy, comme le guide d'installation. FiveM pour GTA V Enhanced utilise une autre archive serveur.

Quand mettre à jour

Cfx.re publie notamment deux canaux :

Canal Usage
recommended Version conseillée pour un serveur en production
latest Version la plus récente, utile pour tester une nouveauté ou une correction

Selon la politique de support de Cfx.re, une version recommandée est suivie jusqu'à six semaines après la suivante, et une version latest jusqu'à deux semaines après la suivante. Une version ancienne continue de fonctionner, mais elle n'est plus prise en charge. Les versions non prises en charge de plus de trois mois ne peuvent plus être rejointes depuis la liste des serveurs.

Étape 1 : relever les versions

Le serveur étant démarré, affichez la version installée :

Terminal
curl -fsS http://127.0.0.1:30120/info.json | grep -oE '"server":"[^"]*"'
sudo grep -E "^version" /home/fivem/server/alpine/opt/cfx-server/citizen/system_resources/monitor/fxmanifest.lua

La première ligne affiche par exemple FXServer-master v1.0.0.12345 linux : le numéro de build est le dernier nombre, ici 12345. La seconde donne la version de txAdmin. Notez ces deux valeurs.

Comparez avec les versions publiées :

Terminal
curl -fsSL https://changelogs-live.fivem.net/api/changelog/versions/linux/server | grep -oE '"(recommended|latest)":"[0-9]+"'

Si votre build est égale à recommended, aucune mise à jour n'est nécessaire.

Étape 2 : sauvegarder

Vérifiez l'espace disque, puis lancez la sauvegarde :

Terminal
df -h /home
sudo du -sh /home/fivem/server
sudo /usr/local/sbin/backup-fivem.sh
sudo ls -lh /home/fivem/backups

Il faut de la place pour une seconde copie de /home/fivem/server. Notez la date de la dernière archive fivem_DATE.tar.gz.

Étape 3 : installer la version recommandée

Arrêtez le serveur, gardez une copie de la version actuelle, puis lancez le script d'installation :

Terminal
sudo systemctl stop fivem.service
sudo -u fivem rm -rf /home/fivem/server.previous
sudo -u fivem cp -a /home/fivem/server /home/fivem/server.previous
sudo -iu fivem /home/fivem/update-fxserver.sh
sudo systemctl start fivem.service

Le script remplace uniquement /home/fivem/server. Vos ressources, server.cfg et les comptes txAdmin restent dans /home/fivem/txData.

Installer une build précise

Cette méthode sert à tester latest ou à choisir une build donnée. Créez un second script :

Terminal
sudo -iu fivem
nano ~/install-fxserver-build.sh
Terminal
#!/bin/bash
set -euo pipefail

URL="${1:?Indiquez en argument le lien vers fx.tar.xz}"

case "$URL" in
  https://runtime.fivem.net/artifacts/fivem/build_proot_linux/master/*/fx.tar.xz) ;;
  *) echo "Adresse refusée : archive Linux officielle attendue" >&2; exit 1 ;;
esac

TMP=$(mktemp -d "$HOME/fxserver.XXXXXX")
trap 'rm -rf "$TMP"' EXIT

curl -fL -o "$TMP/fx.tar.xz" "$URL"
tar -xJf "$TMP/fx.tar.xz" -C "$TMP"
rm -f "$TMP/fx.tar.xz"

[ -x "$TMP/run.sh" ] && [ -d "$TMP/alpine" ] || { echo "Archive incomplète" >&2; exit 1; }

rm -rf "$HOME/server"
mkdir -p "$HOME/server"
mv "$TMP"/* "$HOME/server/"

echo "Version installée : $URL"
Terminal
chmod +x ~/install-fxserver-build.sh
exit

Récupérez ensuite l'adresse voulue. Pour latest :

Terminal
curl -fsSL https://changelogs-live.fivem.net/api/changelog/versions/linux/server | grep -oE '"latest_download":"[^"]*"' | cut -d'"' -f4

Pour une autre build, copiez l'adresse de son fichier fx.tar.xz depuis la liste officielle des builds Linux. Après la sauvegarde de l'étape 2, installez-la en remplaçant ADRESSE_FX_TAR_XZ :

Terminal
sudo systemctl stop fivem.service
sudo -u fivem rm -rf /home/fivem/server.previous
sudo -u fivem cp -a /home/fivem/server /home/fivem/server.previous
sudo -iu fivem /home/fivem/install-fxserver-build.sh 'ADRESSE_FX_TAR_XZ'
sudo systemctl start fivem.service

Étape 4 : vérifier le serveur

Attendez environ une minute, puis contrôlez le service, les ports et la nouvelle version :

Terminal
sudo systemctl is-active fivem.service
sudo ss -tulpn | grep -E ':(30120|40120)\b'
curl -fsS http://127.0.0.1:30120/info.json | grep -oE '"server":"[^"]*"'

Le service doit répondre active, les deux ports doivent écouter et le numéro de build doit avoir changé. Cherchez ensuite les erreurs de démarrage :

Terminal
sudo grep -a -E "Could not (find|start) dependency|Couldn't (find|start) resource|can't run|Failed to load script|SCRIPT ERROR" /home/fivem/fxserver.log

Cette commande ne doit rien renvoyer de nouveau par rapport à d'habitude. Si vous utilisez une base de données, vérifiez aussi la connexion :

Terminal
sudo grep -a 'Database server connection established' /home/fivem/fxserver.log

Connectez-vous enfin au jeu et testez les fonctions principales : connexion du personnage, inventaire, véhicule, commandes d'administration.

Gardez /home/fivem/server.previous quelques jours. Lorsque tout est stable, libérez la place :

Terminal
sudo -u fivem rm -rf /home/fivem/server.previous

Revenir à la version précédente

Remettez le dossier conservé en place :

Terminal
sudo systemctl stop fivem.service
sudo -u fivem rm -rf /home/fivem/server.failed
sudo -u fivem mv /home/fivem/server /home/fivem/server.failed
sudo -u fivem mv /home/fivem/server.previous /home/fivem/server
sudo systemctl start fivem.service

Contrôlez la version avec la commande de l'étape 1, puis regardez la console :

Terminal
sudo tail -n 50 /home/fivem/fxserver.log

Si txAdmin refuse de démarrer après le retour arrière

Une version récente de txAdmin peut avoir converti sa base de joueurs. L'ancienne version s'arrête alors avec ce message :

Texte
Your players database is on v5, and this txAdmin supports up to v4.

Restaurez txData depuis l'archive de l'étape 2, en remplaçant DATE :

Terminal
sudo systemctl stop fivem.service
sudo mv /home/fivem/txData /home/fivem/txData.failed
sudo -u fivem tar -xzf /home/fivem/backups/fivem_DATE.tar.gz -C /home/fivem
sudo systemctl start fivem.service

Les actions faites dans txAdmin depuis cette sauvegarde, comme les bannissements, sont perdues. Il n'est pas nécessaire de restaurer MariaDB : la mise à jour de FXServer ne modifie pas votre base. Supprimez /home/fivem/txData.failed une fois le serveur vérifié.

En cas de problème

Adresse de téléchargement introuvable

Le script n'a pas obtenu de réponse exploitable de Cfx.re. Testez l'accès :

Terminal
curl -fsSI https://changelogs-live.fivem.net/api/changelog/versions/linux/server

Si la commande échoue, vérifiez la connexion sortante et le DNS du serveur, puis réessayez plus tard.

curl: (22) The requested URL returned error: 404

L'adresse de l'archive est incomplète ou erronée. Recopiez-la entièrement, avec le numéro de build, son identifiant et fx.tar.xz.

tar (child): xz: Cannot exec: No such file or directory

Le paquet qui décompresse l'archive est absent :

Terminal
sudo apt install -y xz-utils

No space left on device

Le disque est plein. Repérez ce qui occupe la place avec sudo bash -c 'du -sh /home/fivem/*', puis supprimez les anciens dossiers server.failed et txData.failed ou déplacez des archives hors du serveur. Supprimez aussi tout dossier temporaire /home/fivem/fxserver.* laissé par une coupure.

Le service est actif mais les ports n'écoutent pas

Consultez la console et vérifiez les droits :

Terminal
sudo tail -n 100 /home/fivem/fxserver.log
sudo ls -l /home/fivem/server/run.sh
sudo chown -R fivem:fivem /home/fivem/server

Resource can't run après la mise à jour

Le message Resource 'nom' can't run: suivi de server needs to be 12345 or higher indique que la ressource demande une build plus récente. Installez cette build ou une version plus ancienne de la ressource. Si une ressource fonctionnait avant et échoue autrement, suivez Diagnostiquer les crashs et lenteurs d'un serveur FiveM, ou revenez à la version précédente le temps de corriger.

Avertissement end-of-support ou end-of-life

Le message apparaît aux joueurs et à l'administrateur quand les artifacts sont trop anciens. Un avertissement gris (end-of-support) laisse le serveur accessible. Un avertissement rouge (end-of-life) peut empêcher la connexion : mettez à jour le serveur.