Limpeza, manutenção e desinstalação

Este guia explica como limpar dados em cache, remover licenças, manter o seu ambiente Docker e desinstalar completamente o WP Staging CLI.

Comandos de limpeza

O WP Staging CLI fornece vários comandos de limpeza para gerir dados em cache e credenciais armazenadas.

Limpar ficheiros de cache

Remova respostas de API em cache e dados temporários:

wpstaging clean cache

Os ficheiros de cache incluem:

  • Respostas de validação de licença
  • Cache de respostas da API
  • Ficheiros temporários de transferência

A cache é limpa automaticamente durante a operação normal (entradas com mais de 4 horas são removidas no arranque).

Remover licença armazenada

Remova a chave de licença armazenada localmente sem a desativar no servidor:

wpstaging clean license

Utilize este comando quando pretender:

  • Mudar para uma chave de licença diferente
  • Voltar a introduzir a sua chave de licença
  • Limpar credenciais sem comunicação com o servidor

Nota: Esta ação remove apenas o ficheiro de licença local. A licença permanece ativa na sua conta WP Staging. Utilize wpstaging deactivate para desativar a licença completamente.

Limpar tudo

Remova todos os dados em cache e credenciais armazenadas:

wpstaging clean all

Isto remove:

  • Todos os ficheiros de cache
  • Chave de licença armazenada
  • Outros dados temporários no diretório de trabalho

Desativar licença

Para desativar totalmente a sua licença nos servidores WP Staging e remover o armazenamento local:

wpstaging deactivate

Este comando:

  • Contacta os servidores WP Staging para desativar a licença
  • Liberta um slot de licença na sua conta
  • Remove o ficheiro de licença local

Alias: Pode também utilizar wpstaging unregister.

Remover ambiente Docker

Se utilizou as funcionalidades de Docker, remova todos os contentores, volumes e configurações:

wpstaging remove

Aviso: Esta ação remove permanentemente todos os sites WordPress, bases de dados e configurações Docker. Esta ação não pode ser anulada. Ser-lhe-á pedida confirmação.

Este comando:

  • Para todos os contentores em execução
  • Remove todos os volumes Docker (incluindo dados da base de dados)
  • Remove todas as configurações de sites
  • Remove o diretório ~/wpstaging por completo (ou um --env-path personalizado)

Importante: Execute este comando antes de desinstalar o WP Staging CLI caso tenha utilizado as funcionalidades de Docker.

Desinstalar o WP Staging CLI

Para remover completamente o WP Staging CLI do seu sistema:

Passo 1: Remover dados Docker (se utilizados)

Se utilizou funcionalidades Docker, comece por limpar:

wpstaging remove

Passo 2: Executar o desinstalador

Linux, macOS, WSL:

curl -fsSL https://wp-staging.com/uninstall.sh | bash

Windows PowerShell:

irm https://wp-staging.com/uninstall.ps1 | iex

Windows CMD:

curl -fsSL https://wp-staging.com/uninstall.cmd -o uninstall.cmd && uninstall.cmd && del uninstall.cmd

O desinstalador remove:

  • O binário e os alias do wpstaging
  • Entradas no PATH
  • Scripts de auto-completar do Bash (Linux/macOS)
  • Variável de ambiente da chave de licença
  • Diretórios de cache (~/.wpstaging)

Desinstalação manual

Se preferir desinstalar manualmente:

Linux, macOS:

# Remove the binary
rm ~/.local/bin/wpstaging
# Or if installed system-wide:
sudo rm /usr/local/bin/wpstaging

# Remove bash completion (if installed)
rm ~/.local/share/bash-completion/completions/wpstaging

# Remove license and cache data
rm -rf ~/.wpstaging

# Remove Docker environment (if used)
rm -rf ~/wpstaging

Windows PowerShell:

# Remove the binary
Remove-Item "$env:LOCALAPPDATA\Programs\wpstaging" -Recurse -Force

# Remove from PATH (manual step required)
# Go to System Properties > Environment Variables > User Variables > PATH
# Remove the wpstaging entry

# Remove license and cache data
Remove-Item "$env:USERPROFILE\.wpstaging" -Recurse -Force

# Remove Docker environment (if used)
Remove-Item "$env:USERPROFILE\wpstaging" -Recurse -Force

Quando utilizar cada opção

CenárioComando
Limpar ficheiros temporários e cachewpstaging clean cache
Mudar para uma licença diferentewpstaging clean license e depois wpstaging register
Deixar de usar esta licença nesta máquinawpstaging deactivate
Remover todos os sites e dados Dockerwpstaging remove
Desinstalação completawpstaging remove (se Docker tiver sido utilizado), depois o script de desinstalação
Reiniciar tudo mas manter o CLI instaladowpstaging clean all + wpstaging remove

Resumo dos comandos de limpeza

ComandoO que remove
clean cacheApenas ficheiros de cache
clean licenseApenas o ficheiro de licença local (mantém-se ativa no servidor)
clean allCache + licença local + outros dados temporários
deactivateDesativa no servidor + remove a licença local
removeTodos os contentores, volumes, sites e configurações Docker

Updated on May 23, 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.