Mettre à jour les artifacts FXServer FiveM proprement

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 :

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.

1. Ouvre Startup
2. Identifie la variable : souvent FIVEM_VERSION, FXS_VERSION ou BUILD_VERSION
3. Modifie-la avec le numéro de build cible (ex : 7290)
4. 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 :

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

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

1. 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 :

1. Staging : un second serveur FiveM (peut être SboxDev ou même un VPS perso) où tu testes les artifacts d'abord
2. Annonce : préviens ta communauté 24h avant la maj de prod
3. Fenêtre calme : 3h-5h du matin idéalement
4. Backup systématique
5. Maj prod + monitoring 1h
6. 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.

Ressources

• FiveM Artifacts — Linux
• FiveM Artifacts — Windows
• Cfx.re Forum — Server Development
• FiveM — Docs Server