Atualizar artifacts FiveM sem perder dados: guia seguro passo a passo

Em Linux, entre na pasta dos artifacts e cheque o número da build:

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

A versão aparece como um número de 4 dígitos (ex: 12559). Se o arquivo release.txt não existir, busque o número no nome da pasta onde você descompactou originalmente.

Em Windows, abra PowerShell na pasta dos artifacts e rode:

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

Anote a build atual em algum lugar — você vai precisar pro rollback se necessário.

Acesse https://runtime.fivem.net/artifacts/fivem/ e identifique a build recommended atual. A página lista builds em ordem cronológica reversa; a recommended fica marcada explicitamente. Anote o número da build alvo.

Pare o servidor. No txAdmin, clique em “Stop Server” e aguarde o processo terminar. Pelo terminal, encontre e mate o processo:

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

Em Windows, feche a janela do FXServer.exe ou pare o serviço do txAdmin pelo Painel de Serviços.

Faça backup da pasta dos artifacts. Em Linux:

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

Em Windows, copie a pasta inteira pra um destino seguro (preferencialmente disco diferente ou storage externo). Nomeie com data clara: FXServer-backup-2026-05-29.zip.

Faça dump do banco MySQL. Esse passo é separado porque o banco é independente dos artifacts — mas se você está fazendo manutenção, é o momento ideal pra ter snapshot fresco:

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

Substitua fivem_user e fivem_db pelos nomes reais do seu setup. Confirme que o arquivo .sql.gz não está vazio antes de prosseguir.

Baixe o artifact alvo. No site da runtime.fivem.net, copie o link do .tar.xz (Linux) ou .zip (Windows) da build recommended. Em 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

Substitua o número da build e o COMMIT_HASH pelos valores da build que você está instalando.

Verifique que a extração trouxe os binários esperados. Você deve ver FXServer, a pasta alpine/ (Linux) ou FXServer.exe + DLLs (Windows):

ls server-new/
file server-new/FXServer

Se o FXServer é executável ELF (Linux) ou PE32+ (Windows), está OK. Se a pasta veio vazia ou sem o binário, repita o download — provavelmente o link estava errado ou interrompido.

Faça a troca atômica. A ideia é renomear a pasta antiga pra ficar de fallback e mover a nova pro nome canônico:

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

Em Windows, faça o equivalente no Explorer: renomeie FXServer pra FXServer-old e a pasta nova pra FXServer. Demora um piscar — mas garante que se algo der errado nos próximos passos, você reverte com outro rename instantâneo.

Confirme que as pastas externas estão no lugar correto. A estrutura esperada após a troca:

/home/fivem/
├── server/              (binários novos)
├── resources/           (preservada)
├── server.cfg           (preservada)
├── txData/              (preservada — tokens, perfis, ban list)
└── server-old-20260529/ (backup rápido)

Se você tinha tudo dentro da pasta dos binários antes, agora é hora de copiar resources/, server.cfg e txData/ do server-old-*/ pra fora. Use cp -r (Linux) ou copy/paste (Windows).

Edite o caminho de inicialização se necessário. Se você usa script de start em run.sh ou start.bat, confirme que ele aponta pra server/FXServer (não server-old) e referencia o server.cfg correto:

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

Em Windows, o .bat típico é:

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

Suba o servidor:

sudo systemctl start fivem
journalctl -u fivem -f

Ou rode direto o run.sh/start.bat num terminal interativo pra ver os logs em tempo real durante o boot.

Verifique os logs de boot. Procure por mensagens [citizen-server-impl] Server started. ou equivalente. Erros típicos pós-update aparecem como Couldn't load resource X ou Error parsing server.cfg. Resolva qualquer erro vermelho antes de prosseguir.

Acesse o txAdmin na porta padrão:

Se o txAdmin pede setup completo do zero, a pasta txData/ não foi preservada — pare, restaure o backup, e refaça mantendo txData/ fora da troca de binários.

Conecte um cliente FiveM ao servidor e teste 2-3 resources críticos do seu gamemode (economia, garagem, banco). Se tudo responde normalmente, a atualização está concluída.