Cómo actualizar artifacts FiveM sin perder datos: guía paso a paso

En Linux, entra en la carpeta de los artifacts y revisa el número de la build:

cd /home/fivem/server
ls -la
cat citizen/release.txt 2>/dev/null || head -1 components/citizen-server-impl/CMakeLists.txt

La versión aparece como un número de 4 dígitos (ej: 12559). Si el archivo release.txt no existe, busca el número en el nombre de la carpeta donde descomprimiste originalmente.

En Windows, abre PowerShell en la carpeta de los artifacts y ejecuta:

Get-ChildItem -Name | Select-Object -First 5
Get-Content citizen\release.txt -ErrorAction SilentlyContinue

Anota la build actual en algún lugar — la vas a necesitar para el rollback si es necesario.

Accede a https://runtime.fivem.net/artifacts/fivem/ e identifica la build recommended actual. La página lista builds en orden cronológico inverso; la recommended está marcada explícitamente. Anota el número de la build objetivo.

Detén el servidor. En txAdmin, haz clic en “Stop Server” y espera a que el proceso termine. Desde la terminal, encuentra y mata el proceso:

ps aux | grep FXServer
sudo systemctl stop fivem 2>/dev/null || pkill -f FXServer

En Windows, cierra la ventana de FXServer.exe o detén el servicio de txAdmin desde el Panel de Servicios.

Haz backup de la carpeta de los artifacts. En Linux:

cd /home/fivem
tar -czf backup-artifacts-$(date +%Y%m%d-%H%M).tar.gz server/
ls -lh backup-artifacts-*.tar.gz

En Windows, copia la carpeta entera a un destino seguro (preferentemente disco diferente o storage externo). Nómbrala con fecha clara: FXServer-backup-2026-05-29.zip.

Haz dump de la base MySQL. Este paso es separado porque la base es independiente de los artifacts — pero si estás haciendo mantenimiento, es el momento ideal para tener un snapshot fresco:

mysqldump -u fivem_user -p fivem_db > backup-db-$(date +%Y%m%d-%H%M).sql
gzip backup-db-*.sql

Sustituye fivem_user y fivem_db por los nombres reales de tu setup. Confirma que el archivo .sql.gz no esté vacío antes de seguir.

Baja el artifact objetivo. En el sitio de runtime.fivem.net, copia el link del .tar.xz (Linux) o .zip (Windows) de la build recommended. En Linux:

cd /home/fivem
mkdir -p server-new
cd server-new
wget https://runtime.fivem.net/artifacts/fivem/build_proot_linux/master/12559-COMMIT_HASH/fx.tar.xz
tar -xJf fx.tar.xz
rm fx.tar.xz

Sustituye el número de la build y el COMMIT_HASH por los valores de la build que estés instalando.

Verifica que la extracción haya traído los binarios esperados. Debes ver FXServer, la carpeta alpine/ (Linux) o FXServer.exe + DLLs (Windows):

ls server-new/
file server-new/FXServer

Si el FXServer es ejecutable ELF (Linux) o PE32+ (Windows), está OK. Si la carpeta vino vacía o sin el binario, repite la descarga — probablemente el link estaba mal o se interrumpió.

Haz el intercambio atómico. La idea es renombrar la carpeta antigua para que quede de fallback y mover la nueva al nombre canónico:

cd /home/fivem
mv server server-old-$(date +%Y%m%d)
mv server-new server

En Windows, haz el equivalente en el Explorador: renombra FXServer a FXServer-old y la carpeta nueva a FXServer. Demora un parpadeo — pero garantiza que si algo sale mal en los próximos pasos, reviertes con otro rename instantáneo.

Confirma que las carpetas externas estén en el lugar correcto. La estructura esperada después del intercambio:

/home/fivem/
├── server/              (binarios nuevos)
├── resources/           (preservada)
├── server.cfg           (preservada)
├── txData/              (preservada — tokens, perfiles, ban list)
└── server-old-20260529/ (backup rápido)

Si antes tenías todo dentro de la carpeta de los binarios, ahora es hora de copiar resources/, server.cfg y txData/ desde server-old-*/ hacia fuera. Usa cp -r (Linux) o copy/paste (Windows).

Edita la ruta de inicialización si es necesario. Si usas script de start en run.sh o start.bat, confirma que apunta a server/FXServer (no server-old) y referencia el server.cfg correcto:

#!/bin/bash
cd /home/fivem
./server/run.sh +exec server.cfg

En Windows, el .bat típico es:

@echo off
cd /d C:\FXServer
server\FXServer.exe +exec server.cfg
pause

Sube el servidor:

sudo systemctl start fivem
journalctl -u fivem -f

O ejecuta directamente el run.sh/start.bat en una terminal interactiva para ver los logs en tiempo real durante el boot.

Verifica los logs de boot. Busca mensajes [citizen-server-impl] Server started. o equivalente. Errores típicos post-update aparecen como Couldn't load resource X o Error parsing server.cfg. Resuelve cualquier error rojo antes de seguir.

Accede a txAdmin en el puerto por defecto:

Si txAdmin pide setup completo desde cero, la carpeta txData/ no fue preservada — detente, restaura el backup, y rehaz manteniendo txData/ fuera del intercambio de binarios.

Conecta un cliente FiveM al servidor y prueba 2-3 resources críticos de tu gamemode (economía, garaje, banco). Si todo responde normalmente, la actualización está concluida.