← Blog

txAdmin: como instalar e configurar ESX ou QBCore em 6 passos

Par Benjamin Dayan · PDG

· Mis à jour le 22 de novembro de 2026 · Lecture 7 min

Sumário
Painel web do txAdmin aberto no navegador mostrando console ao vivo e configuração de um servidor FiveM

Para instalar o txAdmin, inicie o FXServer sem server.cfg, abra http://localhost:40120 (ou o endereço exibido no console), digite o PIN exibido no console e crie a conta mestre. O Setup Wizard então implanta uma recipe (receita) de ESX ou QBCore. Na hospedagem FiveM da Fly-Serv, que permite alugar seu servidor GTA RP a partir de R$12,24/mês, o txAdmin já vem pré-instalado.

Conhecer o método manual continua sendo útil, mesmo que você acabe alugando um servidor pronto: no dia em que algo travar, você saberá onde olhar.

Em resumo

  • O txAdmin vem junto com os artifacts do FXServer e escuta na porta TCP 40120 por padrão.
  • O PIN de 4 dígitos aparece no console enquanto não existir uma conta mestre.
  • A receita de ESX ou QBCore é escolhida em "Popular Recipes" e pede uma chave Cfx.re e as credenciais do MariaDB.
  • Os admins são adicionados no "Admin Manager" e os reinícios são programados nas configurações.
  • Um quadro de solução de problemas cobre PIN não encontrado, porta fechada e receita que falha.

txAdmin: o que é e por que usar?

É o painel web oficial para gerenciar servidores FiveM e RedM. Gratuito, de código aberto e distribuído junto com os artifacts do FXServer. Console ao vivo, gestão de jogadores e banimentos, receitas de implantação, reinícios programados, monitoramento, integração com Discord: tudo é controlado pelo navegador. A v8 trouxe as variáveis de ambiente TXHOST_*, que retomamos na etapa 2.

Etapa 1: preparar o FXServer, a chave de licença e o banco de dados

São três itens para reunir antes de iniciar qualquer coisa: os server artifacts, uma chave de licença e um banco MariaDB ou MySQL.

  1. Artifacts: baixe o build recomendado (Windows ou Linux) na documentação da Cfx.re e extraia em uma pasta exclusiva para o servidor.
  2. Chave de licença: o Keymaster foi substituído pelo Cfx.re Portal. Entre em portal.cfx.re com sua conta Cfx.re, abra "Server Registration Keys" e clique no botão grande +. Informe o nome do servidor, a descrição e o idioma. Depois clique em "Generate Key" e copie a chave.
  3. Banco de dados: anote o host, o usuário, a senha e o nome do banco. A receita vai pedir todos eles.

Quanto ao hardware, RAM e CPU dependem principalmente do número de slots e dos scripts. Você encontra referências no nosso guia Quanta RAM para um servidor FiveM?.

Na Fly-Serv, o txAdmin vem pré-instalado e um banco MariaDB está incluído. Só a chave de licença fica por sua conta: você a gera no portal da Cfx.re.

Etapa 2: iniciar o txAdmin e entrar com o PIN

Execute FXServer.exe no Windows ou ./run.sh no Linux, sem +exec server.cfg. O console exibe a URL do painel e um PIN de 4 dígitos. Abra http://localhost:40120, digite o PIN e clique em "Link Account" para vincular sua conta Cfx.re. É esse vínculo que cria a conta mestre (Master account). Aproveite para definir também uma senha de backup.

Se a página não abrir de forma remota, quase sempre é o firewall: libere a porta 40120 em TCP. A porta de jogo 30120 (TCP e UDP) é outra configuração, e o txAdmin se recusa a rodar nela.

Para trocar a porta, a documentação no GitHub indica que, desde a v8, TXHOST_TXA_PORT é o método a usar. Ela tem prioridade sobre a antiga convar txAdminPort, hoje obsoleta.

set TXHOST_TXA_PORT=40125

O PIN muda a cada inicialização enquanto a conta mestre não existir.

Etapa 3: escolher a receita ESX ou QBCore

No Setup Wizard, dê um nome ao servidor e escolha o tipo de implantação: Popular Recipes, Existing Server Data, Remote URL Template ou Custom Template. Para partir de uma base pronta, vá em Popular Recipes e escolha ESX ou QBCore. A lista exata varia conforme a versão do txAdmin. Termine definindo o local dos arquivos (data path).

Existing Server Data serve para reaproveitar a pasta de um servidor existente. As outras duas opções são para receitas hospedadas em uma URL ou escritas por você.

ESX ou QBCore: qual implantar?

Critério ESX QBCore
Comunidade Mais antiga e bastante difundida Ativa, mais recente
Scripts disponíveis Grande volume, qualidade irregular Catálogo menor, mais homogêneo
ox_lib / ox_inventory Instalam-se como resources Instalam-se como resources
Iniciante Muito material de apoio Estrutura mais legível

Na nossa avaliação, o ESX faz sentido se você conta com o volume de scripts disponíveis. O QBCore é mais confortável se quer uma base coerente desde o início. vRP e ox_core também existem. Vamos detalhar essa escolha em um artigo dedicado a ESX vs QBCore.

Etapa 4: informar o banco de dados e executar a receita

A tela de configurações pede a chave de licença e, em seguida, o host do banco, a porta (3306), o usuário, a senha e o nome do banco. Clique em "Run Recipe" e acompanhe os logs de implantação.

Quando a receita terminar, releia o server.cfg gerado: vale conferir sv_hostname, sv_maxclients e o endpoint 30120. Para o oxmysql, a conexão fica assim:

set mysql_connection_string "mysql://usuario:senha@localhost/nome_do_banco"

Os erros mais frequentes:

  • Acesso MySQL negado: usuário, senha ou host incorretos.
  • Banco já existente: esvazie-o ou crie um novo.
  • Chave inválida: gere-a de novo no portal e cole sem espaços.

Na Fly-Serv, o banco MariaDB está incluído. Os frameworks ESX, QBCore, vRP e ox_core são oferecidos no plano FiveM.

Etapa 5: criar as contas de administrador

Abra o Admin Manager e adicione cada membro da equipe com o nome de usuário Cfx.re e/ou o ID do Discord. Depois marque as permissões: bans, kicks, console, configurações, Live Console, gerenciamento de resources.

Uma conta por pessoa, com os direitos mínimos. Nunca compartilhe a conta mestre: é ela que permite redefinir tudo.

Não confunda essas contas com os grupos do framework. Um admin do txAdmin gerencia o painel. Já o grupo admin dentro do jogo depende do ESX (campo group do jogador no banco) ou do QBCore (permissões ACE no server.cfg).

Etapa 6: programar os reinícios automáticos

Vá em Settings > Restarter e informe os horários no formato HH:MM. Para um servidor RP, 06:00, 14:00 e 22:00 são uma base comum, a ser ajustada aos seus horários de menor movimento. Em algumas versões, a opção fica nas configurações gerais: procure por "Scheduled Restarts".

Segundo o FiveM Minimaps, o txAdmin avisa os jogadores 30, 15, 10, 5, 4, 3, 2 e 1 minutos antes. Esses reinícios limpam a memória que alguns scripts acumulam e dão tempo para os backups terminarem. Se um evento passar do horário, o dashboard permite pular o próximo restart ou disparar um pontual.

Faça um backup do banco antes dos restarts mais sensíveis.

Solução de problemas: PIN não encontrado, porta fechada, receita travada

  • O PIN não aparece: o txAdmin já está configurado. Pare o servidor, renomeie txData/admins.json, reinicie e recrie a conta mestre. Os demais admins precisarão ser adicionados de novo.
  • A porta 40120 está inacessível: verifique o firewall, o protocolo (TCP) e o IP. Não use a 30120.
  • A receita falha: confira primeiro as credenciais do banco e depois a chave de licença.
  • O servidor reinicia em loop: algum resource está travando. Leia a Live Console, desative-o e reinicie.
  • Atualização do txAdmin: substitua os artifacts por um build recente, já que o txAdmin vem integrado a eles.

Ganhe tempo: txAdmin pré-instalado no plano FiveM da Fly-Serv

No plano FiveM da Fly-Serv, o servidor é entregue em menos de 60 segundos, com txAdmin pré-instalado, banco MariaDB incluído e os frameworks ESX, QBCore, vRP e ox_core. Ele roda em Ryzen 9 7950X3D, DDR5 ECC e NVMe, com proteção Anti-DDoS incluída, bastante útil nas noites de evento RP. Não há fidelidade. Os valores partem de R$12,24/mês e a página de preços mostra todas as faixas.

Se preferir cuidar de tudo por conta própria, uma VPS Linux permite seguir as seis etapas acima do início ao fim.

Perguntas frequentes

Qual é a porta padrão do txAdmin?

O txAdmin escuta na porta TCP 40120, diferente da porta de jogo do FXServer (30120). Desde a v8, ela é alterada com a variável TXHOST_TXA_PORT.

Onde encontrar o PIN do txAdmin?

No console do FXServer, na inicialização, enquanto não existir uma conta mestre. Se nada aparecer, já existe um admins.json na pasta txData.

Como adicionar um administrador no txAdmin?

Abra o Admin Manager, adicione a pessoa com o nome de usuário Cfx.re e/ou o ID do Discord e marque as permissões. Dê a cada membro da equipe só o necessário.

Como programar um reinício automático com o txAdmin?

Em Settings > Restarter, adicione horários no formato HH:MM, por exemplo 06:00, 14:00 e 22:00. O txAdmin avisa os jogadores antes de cada restart. O menu pode variar conforme a versão.

Como atualizar o txAdmin?

O txAdmin vem nos server artifacts. Baixe um build recente, substitua os arquivos do servidor e preserve a pasta txData, que guarda suas configurações e seus admins.

O txAdmin também funciona em um servidor RedM?

Sim, é o painel oficial para FiveM e RedM. Na Fly-Serv, um servidor RedM com txAdmin permite implantar um servidor RP com VORP ou RSG.

Seu servidor RP pronto em menos de um minuto

Se a porta, o PIN e o banco de dados já tomaram uma noite inteira sua, vá para um plano em que tudo já está no lugar. Na hospedagem FiveM da Fly-Serv, com servidor GTA RP a partir de R$12,24/mês, o txAdmin já vem instalado: você escolhe a receita e a gente cuida do resto.

Leia também