LibraHostDocumentación

Documentación

Guías completas para todos nuestros servicios de alojamiento

Toda la documentación

Navegación

🎮 Instalar un servidor FiveM en VPS Linux#

Crea tu propio servidor FiveM para GTA V en un VPS Debian o Ubuntu. Esta guía cubre la instalación completa con txAdmin para gestionar fácilmente tu servidor roleplay.

🎯 Objetivo#

  • Preparar el VPS para FiveM
  • Instalar los artefactos FiveM (fx server)
  • Configurar txAdmin para la gestión del servidor
  • Lanzar y mantener el servidor

🧰 Requisitos previos#

  • Un VPS con Debian 11/12 o Ubuntu 20.04/22.04/24.04
  • Mínimo 2 vCPU, 4 GB RAM, 30 GB SSD
  • Acceso root o sudo
  • Una clave de licencia CFX (gratuita en Cfx.re Keymaster)
  • Conexión SSH

1️⃣ Actualizar el sistema#

sudo apt update && sudo apt upgrade -y
sudo apt autoremove --purge -y

2️⃣ Instalar dependencias#

🔹 Paquetes necesarios#

sudo apt install -y wget curl tar xz-utils screen git nano

🔹 Crear un usuario dedicado#

⚠️ Importante: Nunca ejecutes FiveM como root por razones de seguridad.

sudo adduser fivem
sudo usermod -aG sudo fivem

Cambia a este usuario:

su - fivem

3️⃣ Descargar los artefactos FiveM#

🔹 Crear el directorio de instalación#

mkdir -p ~/fxserver/server
cd ~/fxserver/server

🔹 Descargar la última versión#

Obtén el enlace de los últimos artefactos en runtime.fivem.net luego:

wget https://runtime.fivem.net/artifacts/fivem/build_proot_linux/master/XXXX-XXXXXXXXX/fx.tar.xz

💡 Consejo: Reemplaza XXXX-XXXXXXXXX por el número de build más reciente (recomendado: última versión estable).

🔹 Extraer los archivos#

tar -xvf fx.tar.xz
rm fx.tar.xz

4️⃣ Obtener una clave de licencia CFX#

  1. Ve a Cfx.re Keymaster
  2. Inicia sesión con tu cuenta Cfx.re (o crea una)
  3. Haz clic en "Register a new server"
  4. Completa la información:
    • Label: Nombre de tu servidor
    • Server IP Address: La IP de tu VPS
    • Server Type: VPS / Dedicated Server
  5. Haz clic en "Generate"
  6. Copia la clave generada (formato: cfxk_xxxxxxxxxxxxxxxxxxxx_xxxxx)

⚠️ Importante: Mantén esta clave en secreto. Nunca la compartas públicamente.

5️⃣ Primer inicio y configuración de txAdmin#

🔹 Iniciar el servidor por primera vez#

⚠️ Importante: En el primer inicio, no uses +exec server.cfg porque el archivo aún no existe. txAdmin nos guiará para crearlo.

cd ~/fxserver/server
screen -S fivem

Una vez en el screen, inicia el servidor:

./run.sh

Deberías ver algo como:

         ████████████████████████████████
         █████████████████████████████████████

         txAdmin v7.x.x starting...

         Use the PIN below to register:
         ========================
              1234
         ========================

         Admin URL: http://0.0.0.0:40120/

💡 Nota: Anota el PIN de 4 dígitos mostrado, lo necesitarás para configurar txAdmin.

🔹 Desconectarse del screen#

Presiona Ctrl + A luego D para desconectarte del screen (el servidor sigue ejecutándose en segundo plano).

🔹 Acceder a txAdmin#

  1. Abre tu navegador y ve a:
http://IP_DE_TU_VPS:40120

  1. Ingresa el PIN mostrado en la terminal

  2. Crea tu cuenta de administrador de txAdmin (nombre de usuario + contraseña)

  3. Sigue el asistente de configuración:

    Paso 1 - Backup: Omite o configura según tus necesidades

    Paso 2 - Server Name: Dale un nombre a tu servidor

    Paso 3 - Deploy Type: Elige "Popular Recipes" luego selecciona una plantilla:

    • CFX Default: Servidor básico vanilla
    • QBCore: Framework RP popular
    • ESX Legacy: Otro framework RP popular

    Paso 4 - Data Location: Define la ruta:

    /home/fivem/fxserver/server-data

    Paso 5 - License Key: Pega tu clave de licencia CFX (obtenida en el paso 4 de esta guía)

    Paso 6 - Review & Save: Revisa y confirma

  4. txAdmin descargará los recursos y creará server.cfg automáticamente

  5. Una vez completado, haz clic en "Start Server" en txAdmin

🔹 Comandos útiles de screen#

ComandoDescripción
screen -S fivemCrear un nuevo screen llamado "fivem"
Ctrl + A luego DDesconectar screen (servidor continúa)
screen -r fivemReconectarse al screen
screen -lsListar screens activos
exit o Ctrl + DCerrar screen (⚠️ detiene el servidor)

🔹 Si tienes problemas con screen#

Si screen se cierra inmediatamente, ejecuta directamente sin screen para ver los errores:

./run.sh

Lee los mensajes de error mostrados, luego corrige el problema antes de reiniciar con screen.

6️⃣ Configuración del server.cfg#

El archivo server.cfg se encuentra en tu carpeta server-data. Aquí están los ajustes esenciales:

nano ~/fxserver/server-data/server.cfg

🔹 Ajustes básicos#

# Nombre y descripción del servidor
sv_hostname "Mi Servidor FiveM - LibraHost"
sv_projectDesc "Servidor Roleplay GTA V"
sv_projectName "MiServidor"

# Clave de licencia (generada en Keymaster)
sv_licenseKey "cfxk_xxxxxxxxxxxxxxxxxxxx_xxxxx"

# Número máximo de jugadores
sv_maxclients 32

# Activar OneSync (recomendado)
set onesync on

# Endpoint del servidor
endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"

# RCON (opcional - para administración remota)
rcon_password "ContrasenaMuySegura123!"

# Tags para la lista de servidores (opcional)
sets tags "roleplay, español, custom"

# Idioma
sets locale "es-ES"

🔹 Recursos esenciales#

# Recursos base
ensure mapmanager
ensure chat
ensure spawnmanager
ensure sessionmanager
ensure basic-gamemode
ensure hardcap

7️⃣ Inicio automático al arrancar (opcional)#

💡 Nota: Este método reemplaza el uso de screen. Elige o screen (paso 5), o systemd (este paso), pero no ambos al mismo tiempo.

🔹 Crear un servicio systemd#

sudo nano /etc/systemd/system/fivem.service

Pega el siguiente contenido:

[Unit]
Description=FiveM Server
After=network.target

[Service]
Type=simple
User=fivem
WorkingDirectory=/home/fivem/fxserver/server
ExecStart=/home/fivem/fxserver/server/run.sh
Restart=on-failure
RestartSec=10

[Install]
WantedBy=multi-user.target

🔹 Activar el servicio#

sudo systemctl daemon-reload
sudo systemctl enable fivem
sudo systemctl start fivem

🔹 Comandos de gestión#

ComandoDescripción
sudo systemctl start fivemIniciar el servidor
sudo systemctl stop fivemDetener el servidor
sudo systemctl restart fivemReiniciar el servidor
sudo systemctl status fivemVer el estado
journalctl -u fivem -fVer logs en tiempo real

8️⃣ Añadir recursos#

🔹 Estructura de carpetas#

~/fxserver/
├── server/          # Artefactos FiveM
└── server-data/     # Datos del servidor
    ├── resources/   # Tus scripts y mods
    ├── server.cfg   # Configuración
    └── cache/       # Caché del servidor

🔹 Instalar un recurso#

  1. Descarga el recurso (GitHub, foros CFX, etc.)
  2. Colócalo en la carpeta resources:
cd ~/fxserver/server-data/resources
git clone https://github.com/ejemplo/mi-recurso.git
  1. Añádelo al server.cfg:
ensure mi-recurso
  1. Reinicia el servidor o usa txAdmin

9️⃣ FAQ y problemas comunes#

  • ¿No puedes acceder a txAdmin? Asegúrate de usar http://IP:40120 (no https). Verifica que el servidor esté funcionando.

  • ¿Los jugadores no pueden conectarse? Asegúrate de que la clave de licencia sea válida y esté asociada a la IP correcta en Cfx.re Keymaster.

  • ¿Error "Could not find server.cfg"? Es normal en el primer inicio. Sigue el asistente de txAdmin que creará el archivo automáticamente.

  • ¿Screen se cierra inmediatamente? Ejecuta ./run.sh sin screen para ver los errores. Asegúrate de estar en el directorio /home/fivem/fxserver/server.

  • ¿El servidor crashea al iniciar? Revisa los logs con journalctl -u fivem -f (si usas systemd) o en screen. A menudo causado por un recurso mal configurado.

  • ¿Servidor no visible en la lista? Añade sv_master1 "" en server.cfg si quieres permanecer oculto, o verifica tus parámetros sets.

  • ¿Rendimiento lento / lag? Activa OneSync con set onesync on. Asegúrate de que tu VPS tenga suficiente RAM (mínimo 4 GB recomendado).

  • ¿Cómo actualizar los artefactos? Detén el servidor, descarga los nuevos artefactos en ~/fxserver/server, extráelos, luego reinicia.

  • ¿Screen o systemd? Usa screen para pruebas y desarrollo (más flexible). Usa systemd para producción (reinicio automático).

✅ Conclusión#

Tu servidor FiveM está ahora instalado y funcionando en tu VPS LibraHost. Usa txAdmin para gestionar fácilmente jugadores, recursos y configuraciones. No olvides hacer copias de seguridad regulares de tu carpeta server-data.

Contactar con soporte