Registrare la licenza

WP Staging CLI richiede una licenza WP Staging Pro valida (piano Agency o Developer) per estrarre o ripristinare i Backup. Questa guida ti spiega come registrare e gestire la tua licenza.

Il modo più semplice per usare la tua licenza è registrarla una sola volta. Dopo la registrazione, la chiave di licenza viene cifrata e salvata in locale, così non dovrai più inserirla.

Modalità interattiva:

wpstaging register

Ti verrà chiesto di inserire la chiave di licenza. La CLI la convaliderà con i server di WP Staging e la salverà in modo sicuro.

Modalità non interattiva (per script o automazioni):

wpstaging register --license=YOUR_LICENSE_KEY

Dopo la registrazione: potrai eseguire qualsiasi comando senza il flag --license. La chiave di licenza viene cifrata e convalidata automaticamente.

Metodi alternativi

Se preferisci non salvare la licenza, puoi fornirla in altri modi:

Variabile d’ambiente

Imposta la variabile d’ambiente WPSTGPRO_LICENSE per usare la licenza senza salvarla:

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

Flag per singolo comando

Puoi anche fornire la chiave di licenza direttamente con ogni comando:

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

Disattivare la licenza

Per disattivare la licenza sui server di WP Staging e rimuovere la chiave salvata:

wpstaging deactivate

Questo comando:

  • Contatta i server di WP Staging per disattivare la tua licenza
  • Rimuove la chiave di licenza salvata dalla tua macchina locale
  • Libera uno slot di licenza sul tuo account

Alias: in alternativa a deactivate puoi usare anche wpstaging unregister.

Rimuovere la licenza salvata (solo in locale)

Per rimuovere solo la licenza salvata in locale, senza disattivarla sul server:

wpstaging clean license

Questa operazione elimina solo il file di licenza locale. La licenza resta attiva sul tuo account WP Staging. Usa questo comando se vuoi passare a un’altra licenza o reinserire la chiave.

Ordine di priorità della licenza

WP Staging CLI cerca una licenza in questo ordine:

  1. Flag da riga di comando: --license=KEY
  2. Variabile d’ambiente: WPSTGPRO_LICENSE
  3. Licenza salvata: tramite wpstaging register

Viene utilizzata la prima licenza valida trovata.

Risoluzione dei problemi

Convalida della licenza non riuscita

Se viene mostrato un errore di convalida della licenza:

  • Verifica che la chiave di licenza sia corretta
  • Controlla che il tuo abbonamento WP Staging sia attivo
  • Assicurati di avere una licenza Agency o Developer (non Personal)
  • Controlla la tua connessione a internet

Licenza già attivata

Ogni licenza può essere attivata su un numero limitato di dispositivi. Se hai raggiunto il limite:

  1. Disattiva la licenza su un dispositivo non più utilizzato: wpstaging deactivate
  2. Oppure acquista slot di licenza aggiuntivi su wp-staging.com

Impossibile connettersi al server delle licenze

Se la CLI non riesce a raggiungere i server di WP Staging:

  • Controlla la tua connessione a internet
  • Verifica che wp-staging.com sia raggiungibile dalla tua rete
  • Se ti trovi dietro un firewall aziendale, assicurati che il traffico HTTPS in uscita sia consentito

Prossimi passi

Con la licenza registrata, sei pronto per iniziare a usare WP Staging CLI:

Updated on Maggio 23, 2026

Rene Hermenau

Autore: 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.