5 min read Intermediate 6.0k

Mettre à jour les artifacts FXServer FiveM proprement

Published on May 18, 2026 at 04:00 PM

Comment changer la version de FXServer sur ton serveur FiveM Wisp chez VeryCloud sans casser ta config, identifier les versions LTS vs latest, et roller back en cas de souci.

Introduction

FXServer est le binaire serveur FiveM, distribué sous forme d'artifacts versionnés. Chaque version peut introduire des bugs ou breaking changes. Cette procédure t'explique comment mettre à jour proprement, choisir entre LTS et latest, et revenir en arrière si besoin.

Prérequis

Un serveur FiveM chez VeryCloud
Accès Files et Startup dans le panel Wisp
Un backup à jour (impératif avant toute maj)

Étape 1 : Identifier ta version actuelle

Dans txAdmin → Server → Diagnostics, tu vois la version FXServer en haut.

Ou en console FiveM (live) :

version

La version est un numéro à 4 chiffres (ex : 7290).

Étape 2 : Comprendre les channels

FiveM publie sur plusieurs channels :

Channel	Cadence	Recommandé pour
latest	Plusieurs fois par semaine	Dev / serveurs de test
recommended	~Mensuel, stable	Prod standard
optional	Entre les deux	Pas vraiment utile
critical	Hot-fixes uniquement	Si ta version actuelle a un bug grave

Pour un serveur public, reste sur recommended ou parfois latest si tu as besoin d'une feature récente.

Étape 3 : Choisir une version

Va sur https://runtime.fivem.net/artifacts/fivem/build_server_windows/master/ (Windows) ou .../build_proot_linux/master/ (Linux).

Chaque entrée a un format xxxx-hash. Le xxxx est le numéro de build.

Note la version recommended (généralement marquée explicitement) et son URL complète.

Étape 4 : Backup avant maj

Critique : backup complet via Wisp Schedules → Create Backup.

Donne un nom parlant : pre-fxserver-update-7290-to-7305.

Étape 5 : Mettre à jour via Wisp

Dans Wisp, l'image FiveM standard expose une variable de startup pour la version FXServer.

Ouvre Startup
Identifie la variable : souvent FIVEM_VERSION, FXS_VERSION ou BUILD_VERSION
Modifie-la avec le numéro de build cible (ex : 7290)
Save

Au prochain démarrage, Wisp télécharge l'artifact correspondant.

💡 Si ta variable attend une URL complète plutôt qu'un numéro, prends l'URL exacte depuis le runtime FiveM (cf étape 3).

Étape 6 : Restart et observer

Restart depuis la console. Logs attendus :

[txAdmin] Restart initiated
[Wisp]    Downloading FXServer artifact 7290...
[Wisp]    Extracting...
[FXServer] Starting v7290
[FXServer] Server ready

Si le serveur se relance et reste up plus de 5 minutes, c'est OK.

Étape 7 : Tester sur le serveur

Connecte-toi en jeu. Teste :

Spawn / connexion fluide
Les ressources critiques se chargent (/restart <ressource> si besoin)
Pas d'erreur scriptante en console F8

Ouvre txAdmin → System Logs et vérifie qu'il n'y a pas de spam d'erreurs depuis le redémarrage.

Étape 8 : Rollback si pépin

Si la nouvelle version casse quelque chose :

STOP le serveur
Wisp → Startup → remets l'ancien numéro de build
Save + Start

Ou si la conf est plus profondément cassée :

Backups → restore le backup pré-maj

Comptez 2-5 minutes downtime pour un rollback.

Étape 9 : Workflow de maj recommandé

Pour un serveur sérieux :

Staging : un second serveur FiveM (peut être SboxDev ou même un VPS perso) où tu testes les artifacts d'abord
Annonce : préviens ta communauté 24h avant la maj de prod
Fenêtre calme : 3h-5h du matin idéalement
Backup systématique
Maj prod + monitoring 1h
Communiquer le résultat (Discord)

Étape 10 : Schedule de check des versions

Pour ne pas rater une critical update :

Abonne-toi au Discord officiel CFX dans #changelog ou #announcements
Ou check une fois par semaine sur https://forum.cfx.re/c/development/server/137

Dépannage

Le serveur ne redémarre pas après changement de version

Build n'existe pas ou URL incorrecte — vérifie sur runtime.fivem.net
Permissions OS sur le binaire — fait un Reinstall depuis Settings Wisp

Crash au boot avec une nouvelle version

Ressource incompatible avec le nouveau build (souvent oxmysql, ESX/QBCore très anciens)
Rollback immédiat puis mets à jour les ressources avant de retenter

Performance dégradée après la maj

Mémoire qui grimpe : profile avec resmon (voir tuto dédié)
Si pas identifiable, rollback

Commandes utiles

# Voir la version actuelle (console FiveM)
version

# Forcer un restart proprement (txAdmin)
# Panel txAdmin / Server / Restart

# Lister les ressources qui ont planté au boot
# txAdmin / Server / Resources / filter "Failed"

Conclusion

Mettre à jour FXServer = trois clics dans Wisp + un backup. Le piège classique est de skip le backup ou de pousser latest en prod sans staging. Reste sur recommended, garde un staging, et tu n'auras jamais de mauvaise surprise.

Pour aller plus loin : automation des notif de release via webhook GitHub, A/B testing entre deux serveurs.