Cómo crear una license key gratuita para servidor de FiveM
Guía técnica paso a paso para generar una license key gratuita en Cfx.re Keymaster y vincularla a tu servidor FiveM en producción.
Ejecutar un servidor FiveM requiere una license key emitida por el Keymaster, el sistema oficial de Cfx.re. Sin ella, el FXServer rechaza el arranque con el mensaje invalid license key specified y el servidor no aparece en la lista pública. La buena noticia es que existe una key gratuita. Solo necesitas una cuenta en el foro Cfx.re y la IP del servidor donde correrá el FXServer.
Este tutorial está dirigido a quienes están configurando su primer servidor FiveM, ya sea en VPS, dedicado o entorno local de pruebas. Cubriremos el registro en el Keymaster, la generación de la key vinculada a la IP correcta, la configuración en server.cfg y los errores más comunes de validación que aparecen en los primeros minutos de operación.
Prerrequisitos
Antes de generar la key, asegúrate de conocer la IP que alojará el servidor. La license está vinculada a esa dirección — si la generas con una IP incorrecta, tendrás que rehacer el vínculo después.
Necesitas: una cuenta de correo válida para registrarte en el foro Cfx.re, la IP pública del servidor donde correrá el FXServer (IPv4), acceso al panel/SSH para editar el server.cfg, y el FXServer ya instalado (o a punto de instalarse).
Si aún no tienes servidor, define dónde va a correr antes de continuar. La key acepta tres modos de vínculo:
Vincula a un IPv4 específico 127.0.0.1 — solo pruebas locales Acepta cualquier IP, pero con limitaciones Para producción, usa IP fija. Localhost sirve para desarrollo en tu propia máquina. Wildcard funciona, pero Cfx.re puede revocar keys wildcard usadas en servidores públicos con alto número de jugadores.
Crear cuenta en el foro Cfx.re
El Keymaster autentica mediante el foro oficial de Cfx.re — no se crea la cuenta directamente en el panel de keys, sino en el foro, que actúa como SSO para todo el ecosistema FiveM.
Accede a la dirección del foro oficial:
https://forum.cfx.re/Haz clic en Sign Up en la esquina superior derecha. Puedes registrarte con Discord, Google, GitHub o correo electrónico tradicional. Se recomienda Discord si ya participas en comunidades FiveM — facilita el soporte futuro.
Completa el registro con correo válido, nombre de usuario y contraseña. El foro envía un enlace de confirmación por correo — haz clic en él antes de continuar, de lo contrario el Keymaster no reconocerá la cuenta.
Tras confirmar, inicia sesión en el foro al menos una vez para que la sesión quede inicializada.
Accede al Keymaster en la dirección:
https://keymaster.fivem.net/Haz clic en Log in with Cfx.re y autoriza el acceso vía OAuth. Serás redirigido al dashboard del Keymaster, que lista todas tus license keys (ninguna en este momento).
La cuenta del foro da acceso total a tus keys, al hilo de soporte y a la gestión de assets de Cfx.re. Usa una contraseña fuerte y habilita 2FA en la configuración del foro (Preferences → Security).
Generar la license key en el Keymaster
Con la cuenta activa, generar la key lleva menos de un minuto. El sistema permite hasta aproximadamente 9 keys por cuenta de forma gratuita — suficiente para múltiples servidores o entornos de staging.
En el dashboard del Keymaster, haz clic en el botón + o en Generate a new server key en la parte superior de la página.
Verás un formulario con tres campos: server label (nombre descriptivo), IP address y tipo de vínculo.
Rellena el Server Label con un nombre que identifique el servidor — por ejemplo roleplay-prod-01 o dev-local. Este nombre es solo para tu organización interna y no es visible para los jugadores.
En el campo IP address, introduce el IPv4 público del servidor. Si estás en una VPS, obtén la IP con:
curl -4 ifconfig.mePara desarrollo local, usa 127.0.0.1. Para hosting con IP dinámica, selecciona la opción wildcard, pero ten en cuenta sus limitaciones.
Haz clic en Generate. La key se creará y se mostrará con el formato:
cfxk_XXXXXXXXXXXXXXXXXXXXX_YYYYYYYCopia el valor completo. Trata esta cadena como una contraseña — no la publiques en capturas de pantalla, repositorios públicos ni en Discord.
Cfx.re monitoriza activamente las keys expuestas en GitHub y pastebins. Si tu key se filtra, es revocada automáticamente y el servidor cae. Añade server.cfg al .gitignore si versionas la configuración.
Configurar la key en server.cfg
La key debe declararse en el archivo de configuración que el FXServer lee durante el arranque. Por defecto, este archivo se encuentra en ~/server-data/server.cfg en la instalación Linux, o en la carpeta del servidor en Windows.
Abre el archivo de configuración:
nano ~/server-data/server.cfgLocaliza la línea que empieza por sv_licenseKey — generalmente cerca del final del archivo, en la plantilla estándar de txAdmin o del FXServer.
Sustituye el valor de ejemplo por tu key:
sv_licenseKey cfxk_XXXXXXXXXXXXXXXXXXXXX_YYYYYYYNo uses comillas alrededor de la key. No añadas espacios extra. El FXServer hace parsing por whitespace simple y cualquier carácter adicional rompe la validación.
Guarda y cierra el archivo (Ctrl+O, Enter, Ctrl+X en nano).
Reinicia el FXServer. Si usas txAdmin, basta con hacer clic en Restart en el panel web. En ejecución manual:
cd ~/server-data
bash ~/fxserver/run.sh +exec server.cfgVerificación
Un servidor con key válida muestra mensajes específicos en la consola durante el arranque. Confirmas el éxito observando esos logs.
Busca en la consola una secuencia similar a:
Authenticating with [Cfx.re]...
Server license key authentication succeeded.
Server is now available on the server list.
Si la autenticación falla, el FXServer termina con el mensaje Invalid license key specified, or RCON password not set. En ese caso, revisa la key y la IP vinculada.
También puedes verificar mediante la API pública de FiveM si el servidor aparece listado. Sustituye IP:PORT por tu endpoint:
curl http://IP:PORT/info.json
La respuesta debe contener un JSON con vars, version y resources. Si devuelve error de conexión, el problema es el firewall o el puerto — no la key.
Resolución de problemas
Error: invalid license key specified
La causa más común es una IP incorrecta en el Keymaster. Vuelve al dashboard, edita la key (icono de lápiz) y ajusta la IP. El cambio es instantáneo, pero el FXServer necesita reiniciarse para revalidar.
Segunda causa: copiaste la key con un carácter invisible (espacio, salto de línea). Borra la línea completa en server.cfg y escríbela de nuevo, o usa echo para garantizar un formato limpio:
echo 'sv_licenseKey cfxk_TU_KEY_AQUI' >> server.cfg
Error: license key has expired or been revoked
Las keys del Keymaster no caducan por tiempo, pero se revocan en tres situaciones: filtración pública detectada por Cfx.re, infracción de los términos de servicio (uso comercial sin licencia adecuada para servidores grandes), o eliminación manual por el propietario de la cuenta. Genera una nueva key en el dashboard.
El servidor arranca pero no aparece en la lista pública
En este caso, la key funcionó, pero hay otro problema. Comprueba que sv_endpoints está configurado correctamente y que el puerto 30120 (UDP y TCP) está abierto en el firewall:
sudo ufw allow 30120/tcp
sudo ufw allow 30120/udp
El servidor puede tardar hasta 2 minutos en aparecer en la lista pública tras el primer arranque exitoso.
Genera keys separadas para producción y staging — usar la misma key en dos servidores simultáneos invalida ambos. Como el límite es de aproximadamente 9 keys por cuenta, hay margen suficiente para entornos de prueba sin conflicto.
Próximos pasos
Con la key configurada, el servidor está técnicamente operativo. A partir de aquí, vale la pena profundizar en:
- Configurar txAdmin para gestionar el servidor vía web (start/stop, consola remota, backups)
- Implementar OneSync si planeas más de 32 jugadores simultáneos
- Ajustar
sv_maxClientsy parámetros de rendimiento enserver.cfg - Configurar resources esenciales: ESX o QBCore para frameworks de roleplay
- Implementar backup automatizado de la base de datos MySQL y de la carpeta
resources
Si vas a poner el servidor en producción con más de 32 slots, una VPS Hostini con NVMe y baja latencia al backbone de Cfx.re reduce los drops de tickrate en horas pico — el cuello de botella típico de FiveM es I/O de base de datos y CPU single-thread, ambos cubiertos por los planes con vCPU dedicada.
Preguntas frecuentes
¿La license key de FiveM es realmente gratuita?
Sí. El Keymaster de Cfx.re emite keys gratuitas sin límite de tiempo para servidores de hasta 48 slots. Los servidores más grandes pueden necesitar Patreon Argentum o superior, pero la key en sí sigue siendo gratuita — el Patreon habilita slots adicionales, no desbloquea la license.
¿Puedo usar la misma key en dos servidores al mismo tiempo?
No. Cfx.re detecta el uso simultáneo de la misma key en IPs diferentes y suspende ambas instancias. Para staging y producción, genera keys separadas — tu cuenta permite aproximadamente 9 keys activas.
¿Necesito cambiar la key si cambio la IP del servidor?
No es necesario generar una nueva. Accede al Keymaster, haz clic en el icono de edición de la key existente y actualiza el campo IP. El cambio se propaga en segundos y basta con reiniciar el FXServer para revalidar.
¿Qué ocurre si mi key se filtra en GitHub?
Cfx.re ejecuta escaneos automáticos en repositorios públicos. Las keys detectadas en commits públicos son revocadas en un plazo de 24 horas. Añade siempre server.cfg al .gitignore y utiliza variables de entorno o archivos separados para los secretos.
¿Cuál es la diferencia entre una key wildcard y una key con IP fija?
Wildcard acepta conexión desde cualquier IP, útil para hosting con IP dinámica o entornos contenerizados. IP fija es más segura y estable para producción. Wildcard tiene limitaciones implícitas de slots y puede ser señalada en servidores grandes.
¿Puedo usar una key de FiveM en un servidor RedM?
No. RedM (port para Red Dead Redemption 2) utiliza keys del mismo Keymaster, pero generadas en un flujo separado dentro del panel. Al crear la key, el sistema pregunta el tipo de servidor — selecciona RedM para ese caso.