Registrar licencia

WP Staging CLI requiere una licencia válida de WP Staging Pro (plan Agency o Developer) para extraer o restaurar Backups. Esta guía explica cómo registrar y gestionar tu licencia.

La forma más sencilla de usar tu licencia es registrarla una vez. Tras el registro, tu clave de licencia se cifra y almacena localmente, por lo que no necesitarás introducirla de nuevo.

Modo interactivo:

wpstaging register

Se te pedirá que introduzcas tu clave de licencia. La CLI la validará con los servidores de WP Staging y la almacenará de forma segura.

Modo no interactivo (para scripts/automatización):

wpstaging register --license=YOUR_LICENSE_KEY

Tras el registro: puedes ejecutar cualquier comando sin el indicador --license. Tu clave de licencia se cifra y valida automáticamente.

Métodos alternativos

Si prefieres no almacenar tu licencia, puedes proporcionarla de otras formas:

Variable de entorno

Establece la variable de entorno WPSTGPRO_LICENSE para usar tu licencia sin almacenarla:

Linux, macOS, WSL:

# Set for current session
export WPSTGPRO_LICENSE=YOUR_LICENSE_KEY

# Or add to ~/.bashrc or ~/.zshrc for permanent use
echo 'export WPSTGPRO_LICENSE=YOUR_LICENSE_KEY' >> ~/.bashrc

Windows PowerShell:

# Set for current session
$env:WPSTGPRO_LICENSE="YOUR_LICENSE_KEY"

# Or add to your PowerShell profile for permanent use
Add-Content $PROFILE '$env:WPSTGPRO_LICENSE="YOUR_LICENSE_KEY"'

Windows CMD:

set WPSTGPRO_LICENSE=YOUR_LICENSE_KEY

Indicador por comando

También puedes proporcionar tu clave de licencia directamente en cada comando:

wpstaging extract --license=YOUR_LICENSE_KEY backup.wpstg
wpstaging restore --license=YOUR_LICENSE_KEY --path=/var/www/html backup.wpstg

Desactivar licencia

Para desactivar tu licencia en los servidores de WP Staging y eliminar la clave almacenada:

wpstaging deactivate

Este comando:

  • Contacta con los servidores de WP Staging para desactivar tu licencia
  • Elimina la clave de licencia almacenada de tu máquina local
  • Libera un slot de licencia en tu cuenta

Alias: también puedes usar wpstaging unregister como alternativa a deactivate.

Eliminar licencia almacenada (solo local)

Para eliminar solo la licencia almacenada localmente sin desactivarla en el servidor:

wpstaging clean license

Esto solo elimina el archivo de licencia local. La licencia permanece activa en tu cuenta de WP Staging. Úsalo si quieres cambiar a una licencia diferente o volver a introducir tu clave.

Orden de prioridad de licencias

WP Staging CLI comprueba una licencia en este orden:

  1. Indicador de línea de comandos: --license=KEY
  2. Variable de entorno: WPSTGPRO_LICENSE
  3. Licencia almacenada: de wpstaging register

Se usa la primera licencia válida encontrada.

Solución de problemas

Error de validación de licencia

Si ves un error de validación de licencia:

  • Verifica que tu clave de licencia es correcta
  • Comprueba que tu suscripción a WP Staging está activa
  • Asegúrate de tener una licencia Agency o Developer (no Personal)
  • Comprueba tu conexión a internet

Licencia ya activada

Cada licencia puede activarse en un número limitado de dispositivos. Si has alcanzado tu límite:

  1. Desactiva la licencia en un dispositivo no utilizado: wpstaging deactivate
  2. O compra slots de licencia adicionales en wp-staging.com

No se puede conectar al servidor de licencias

Si la CLI no puede conectarse a los servidores de WP Staging:

  • Comprueba tu conexión a internet
  • Verifica que wp-staging.com sea accesible desde tu red
  • Si estás detrás de un firewall corporativo, asegúrate de que el tráfico HTTPS saliente está permitido

Pasos siguientes

Con tu licencia registrada, estás listo para empezar a usar WP Staging CLI:

Updated on mayo 22, 2026

Rene Hermenau

Autor: Rene Hermenau

About the author: René Hermenau is the founder of WP STAGING. He works on WordPress backups, staging, migrations, database handling, and safe deployment workflows.