Como configurar o WP-CLI via SSH para gerenciar o WordPress pela linha de comando

Como configurar o WP-CLI via SSH para gerenciar o WordPress pela linha de comando

Oi, tudo bem? Aqui é a Sensei da GeHost 🥋 e hoje eu vou te ensinar uma ferramenta que muita gente nem sabe que existe, mas que é um baita atalho pra quem cuida do próprio WordPress no dia a dia: o WP-CLI. Com ele, você atualiza plugins, faz backup e resolve várias coisas digitando um comandinho no terminal, sem precisar clicar em telas e mais telas do painel. Bora com calma, passo a passo, que não tem mistério nenhum.

O que é o WP-CLI, afinal?

WP-CLI é uma ferramenta de linha de comando oficial do WordPress. Em vez de entrar no painel administrativo do site e navegar por menus, você digita comandos direto no terminal (via SSH) e o WordPress executa a ação na hora — atualizar plugins, temas, o próprio núcleo do WordPress, listar usuários, exportar o banco de dados, entre outras coisas.

Dica da Sensei: essa é uma ferramenta mais técnica. Se você nunca usou terminal/linha de comando antes, não tem problema nenhum em pedir uma força pro nosso suporte — a gente te ajuda a dar os primeiros passos com tranquilidade.

Passo 1 — Confirme se o acesso SSH está liberado na sua conta

O acesso via SSH pode precisar ser habilitado especificamente na sua conta de hospedagem. Antes de mais nada:

1. Acesse o cPanel da sua hospedagem (o link e os dados de acesso ficam disponíveis no painel.gehost.com.br).
2. Faça login com seu usuário e senha do cPanel.

Depois de logado, dê uma olhada na tela inicial do cPanel, na área de ferramentas — se você tiver acesso SSH habilitado, geralmente aparece uma opção relacionada a "Acesso SSH" (SSH Access) nessa área.

Não achou a opção de SSH? Sem problema — chama a gente no suporte e a equipe confirma se o SSH está liberado no seu plano e te ajuda a ativar.

Passo 2 — Conecte no servidor via SSH

Com o acesso confirmado, você vai precisar de um programa de terminal no seu computador:

• Windows: pode usar o PuTTY, o Windows Terminal ou o PowerShell.
• Mac/Linux: o próprio aplicativo de "Terminal" já serve.

O comando básico de conexão é assim (troque pelos seus dados reais, que o suporte te confirma):

• ssh seu_usuario@seudominio.com.br

Na primeira vez, o terminal pode perguntar se você confia na conexão — digite yes e aperte Enter. Em seguida, informe sua senha de acesso (ela não aparece na tela enquanto você digita, é assim mesmo, não é bug 😄).

Passo 3 — Veja se o WP-CLI já está disponível

Muitos ambientes de hospedagem já vêm com o WP-CLI instalado. Pra checar, com a sessão SSH aberta, digite:

• wp --info

Se aparecerem informações de versão do PHP, do WP-CLI etc., ótimo — já está tudo pronto e você pode pular direto pro Passo 5. Se aparecer uma mensagem de "comando não encontrado", siga pro próximo passo.

Passo 4 — Instalando o WP-CLI (se ainda não tiver)

1. Baixe o arquivo oficial do WP-CLI:
   curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar
2. Teste se baixou certo:
   php wp-cli.phar --info
3. Dê permissão de execução e renomeie pra facilitar o uso:
   chmod +x wp-cli.phar
mv wp-cli.phar wp
4. Agora, sempre que for usar, é só chamar com ./wp (a partir da pasta onde ele ficou salvo) ou configurar o caminho com o suporte pra usar só wp de qualquer lugar.

Dica da Sensei: em hospedagem compartilhada nem sempre dá pra instalar programas em qualquer pasta do sistema — se você tiver alguma mensagem de "permissão negada", chama o suporte que a gente te orienta certinho pro seu ambiente.

Passo 5 — Vá até a pasta do seu WordPress

O WP-CLI só funciona dentro da pasta onde o WordPress está instalado (geralmente public_html, ou uma subpasta dela se o site estiver num subdiretório). Use:

• cd public_html

Se você tiver dúvida de qual é o caminho exato do seu site, dá pra conferir pelo Gerenciador de Arquivos do cPanel — a estrutura de pastas que aparece lá é a mesma que você vai navegar pelo terminal.

Passo 6 — Comandos do dia a dia que valem ouro

Com o WP-CLI funcionando dentro da pasta do site, aqui vão alguns comandos bem úteis:

• Ver a versão do WordPress: wp core version
• Listar plugins instalados: wp plugin list
• Atualizar todos os plugins: wp plugin update --all
• Atualizar o núcleo do WordPress: wp core update
• Listar usuários do site: wp user list
• Exportar o banco de dados (backup): wp db export backup.sql

Antes de mexer em qualquer coisa: faça um backup

Atualizar plugin ou tema pela linha de comando é rápido — mas rápido também pode ser reverter se algo não sair como esperado. Por isso, sempre faça um backup antes de rodar comandos de atualização ou alteração.

Regra de ouro da Sensei: faça o backup completo (ou pelo menos do banco de dados) pela tela de Backup do cPanel antes de rodar wp core update ou wp plugin update --all. Assim, se alguma coisa não gostar da atualização, é só restaurar e seguir a vida tranquilo.

Passo 7 — Encerrando a sessão

Quando terminar, é só digitar:

• exit

Isso fecha a conexão SSH com segurança.

Ficou com alguma dúvida?

Sem problema nenhum — linha de comando assusta no começo, mas com a prática vira rotina. Se precisar de ajuda pra habilitar o SSH, confirmar o caminho da instalação do seu WordPress ou entender alguma mensagem de erro, é só chamar o suporte da GeHost. A gente adora ajudar. 🙂