Instalar o WP Staging CLI

Este guia explica como instalar o WP Staging CLI no seu computador. A ferramenta CLI permite extrair, restaurar e gerir backups WordPress a partir da linha de comandos.

O que vai precisar

  • Uma licença WP Staging Pro válida (plano Agency ou Developer)
  • Para extrair/restaurar: qualquer sistema moderno com 512 MB de RAM
  • Para funcionalidades Docker: 2 núcleos de CPU, 4 GB de RAM, Docker 20.10.0+, Docker Compose 2.19.0+

O instalador transfere automaticamente a versão correta para o seu sistema operativo, verifica os checksums e adiciona o comando ao seu PATH.

Linux, macOS, WSL:

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

Windows PowerShell:

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

Windows CMD:

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

O que o instalador faz:

  • Transfere a versão mais recente para a sua plataforma
  • Verifica os checksums para garantir a segurança
  • Instala em ~/.local/bin (Linux/macOS) ou %LOCALAPPDATA%\Programs\wpstaging (Windows)
  • Adiciona ao PATH automaticamente
  • Instala o auto-completar do bash (Linux/macOS)

Instalar uma versão específica

Verifique se está disponível uma versão mais recente

wpstaging update --check

Instalar a versão mais recente

wpstaging update

Para instalar uma versão específica, incluindo beta, alfa ou release candidate (atualizar ou regredir):

wpstaging update --version 1.9.1

Consulte todas as versões disponíveis em GitHub Releases.

Instalação manual

Se preferir transferir e instalar manualmente:

  1. Transfira o arquivo da versão mais recente em GitHub Releases (main.zip)
  2. Extraia o arquivo e localize o binário na pasta build correspondente à sua plataforma:
    • Linux: build/linux_amd64/wpstaging (64 bits) ou build/linux_i386/wpstaging (32 bits)
    • macOS: build/macos_arm64/wpstaging (Apple Silicon) ou build/macos_amd64/wpstaging (Intel)
    • Windows: build/windows_amd64/wpstaging.exe (64 bits) ou build/windows_i386/wpstaging.exe (32 bits)
  3. Torne-o acessível a partir de qualquer local do computador (ver abaixo)

Linux, macOS (instalação por utilizador):

# User installation (no sudo required)
mkdir -p ~/.local/bin
mv wpstaging ~/.local/bin/
chmod +x ~/.local/bin/wpstaging

Linux, macOS (instalação à escala do sistema):

sudo mv wpstaging /usr/local/bin/
sudo chmod +x /usr/local/bin/wpstaging

Windows:

  1. Crie um diretório: C:\Program Files\wpstaging\
  2. Mova o wpstaging.exe para esse diretório
  3. Adicione C:\Program Files\wpstaging\ à variável de ambiente PATH

Verificar a instalação

Após a instalação, confirme que está a funcionar verificando a versão:

wpstaging --version

Deverá ver uma saída semelhante a:

wpstaging version 1.5.1

Para ver todos os comandos disponíveis:

wpstaging --help

Desinstalação

Para remover o WP Staging CLI do seu sistema:

Mínimo: desativa a licença e remove o binário, os ficheiros de auto-completar e as entradas do PATH

wpstaging uninstall

Completo: também executa o fluxo de remoção do script de instalação (cache, sites Docker, etc.)

wpstaging uninstall --full

Ou transfira e execute o desinstalador diretamente:

Linux, macOS, WSL:

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

Windows Powershell:

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

Windows CMD:

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

O que o desinstalador remove:

  • O binário e os alias do wpstaging
  • Entradas no PATH
  • Variável de ambiente da chave de licença
  • Diretórios de cache

Próximos passos

Após a instalação, será necessário registar a licença antes de utilizar o CLI:

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.