Docs / rApanel / Tu licencia

Tu licencia

El instalador registra tu panel y deja la clave guardada; a partir de ahí se revalida solo cada hora y no tienes que hacer nada. Esta guía es para los días en que sí hay que hacer algo: renovaste, cambiaste de plan, moviste el servidor de máquina, o el panel dejó de guardar cambios y quieres saber por qué.

Lo primero, para que no cunda el pánico: una licencia que deja de valer no apaga tu servidor. Tus jugadores no se enteran de nada.

1 · Qué se bloquea y qué no #

El bloqueo es deliberadamente parcial, porque el problema es entre tú y nosotros y no tiene por qué pagarlo tu comunidad:

  • Tu sitio público sigue igual — la portada, las noticias, el ranking, la wiki, las descargas.
  • Tus jugadores siguen igual — se registran, entran, crean y gestionan sus cuentas de juego.
  • El administrador se puede seguir navegando — puedes entrar y mirarlo todo.
  • Lo único que se detiene es guardar cambios desde el administrador.

Verás un aviso en rojo arriba del panel explicando el motivo, y al intentar guardar algo te lo impedirá con ese mismo mensaje.

2 · La pantalla de licencia #

Está en Admin → Sistema → Licencia y muestra el estado, el motivo cuando no es válida, tu clave enmascarada y cuándo se comprobó por última vez.

El botón Revalidar ahora es el que resuelve la mayoría de los casos. El panel comprueba su licencia una vez por hora, así que cuando renuevas una licencia vencida —o cuando te reactivan una instalación revocada— el cambio ya está hecho en nuestro servidor y el tuyo todavía no se ha enterado. Ese botón le dice que mire ahora.

Esta pantalla funciona también con el panel bloqueado. Es a propósito: si el bloqueo alcanzara al formulario que arregla la licencia, no habría forma de salir.

3 · Cambiar la clave sin reinstalar #

Si pasas a otro plan recibes una clave nueva. No hay que reinstalar nada: en la misma pantalla, Cambiar la clave de licencia, la pegas y listo. Tu panel no cambia hasta que nuestro servidor acepta la clave, así que si te equivocas al copiarla no rompes nada.

Lo mismo por consola, si prefieres no entrar al navegador:

cd /var/www/rapanel
sudo -u www-data php artisan license:activate TU-CLAVE-DE-LICENCIA

4 · Mover el panel a otro servidor #

Tu licencia se ata a la máquina, no al dominio ni a la carpeta. Para moverla no hay que escribir ningún comando: basta con activar el panel en el servidor nuevo.

Si instalas de cero en la máquina nueva:

  • Entra en tu cuenta y pulsa Liberar en la instalación anterior.
  • Corre el instalador en el servidor nuevo y pega tu clave. Listo.

Si restauras una copia de seguridad en otra máquina:

  • Abre Admin → Sistema → Licencia en el panel restaurado.
  • Pulsa Cambiar la clave de licencia y pega tu clave — la misma de siempre, si no ha cambiado.
  • Esa máquina pasa a ser la instalación registrada.

Es el mismo botón que se usa para cambiar de plan. No tienes que saber en cuál de los dos casos estás: el panel se identifica solo y hace lo que corresponda.

Cambiar de dominio no afecta a nada. El dominio no forma parte de esa identidad: puedes pasar de una IP a un dominio, o cambiar el nombre de tu servidor, sin tocar la licencia.

5 · Qué significa cada motivo #

  • Venció — renuévala y pulsa Revalidar ahora.
  • Suspendida — la suspendió quien la emitió. Escríbenos.
  • Instalación revocada — este servidor se dio de baja de la licencia. Lo revierte quien la emitió; tú no puedes hacerlo por tu cuenta.
  • No activada — la clave existe, pero este servidor no está registrado en ella. Usa Cambiar la clave o el comando de arriba.
  • Clave desconocida — esa clave no existe. Revisa que esté completa y sin espacios de más.
  • Sin cupo libre — la licencia ya ocupa todas sus instalaciones. Entra a tu cuenta, libera la que ya no uses y vuelve a intentarlo.
  • Sin conexión — no se pudo contactar con el servidor de licencias. Aquí no hay prisa: el panel aguanta siete días así antes de bloquear nada, de modo que un corte de red o un mantenimiento nuestro no te deja tirado.

6 · Si dice que no pudo guardar la clave #

Puede pasar que la pantalla te diga que la licencia quedó activada pero que no pudo guardar la clave. No es un error tuyo ni del panel: significa que el archivo de configuración está protegido contra escritura, que es exactamente lo que recomendamos en la guía de seguridad. No lo deshagas.

La licencia ya está activada en nuestro servidor; solo falta que tu panel guarde la clave. La propia pantalla te muestra el comando exacto para terminarlo:

sudo -u www-data php artisan license:activate TU-CLAVE-DE-LICENCIA

¿Solo quieres ver cómo está la licencia sin tocar nada? php artisan license:check te dice si es válida y si el panel está bloqueado.