Como instalar WordPress com WP CLI em uma VPS

Instalar WordPress com WP CLI é uma forma direta de preparar o sistema pela linha de comando. Você baixa os arquivos, cria o arquivo de configuração, conecta o banco de dados e registra o primeiro administrador sem depender do instalador aberto no navegador.

Esse método faz sentido em uma VPS já preparada com servidor web, PHP, banco de dados e acesso SSH. Ele também ajuda quem administra vários sites e deseja repetir um processo documentado. Para uma primeira instalação sem experiência com terminal, o guia geral de instalação do WordPress oferece um caminho mais simples.

O WP CLI não configura sozinho toda a infraestrutura. DNS, certificado SSL, servidor web, permissões, atualizações e backup continuam sob sua responsabilidade. Faça a instalação primeiro em um ambiente de teste quando não conhecer a configuração da VPS.

O que você vai instalar com o WP CLI

Ao final deste guia, a VPS terá uma instalação funcional do WordPress associada a um banco de dados existente. O processo cobre:

1. Verificação do WP CLI e do PHP.
2. Criação do diretório do site.
3. Download do WordPress em português do Brasil.
4. Geração do arquivo wp-config.php.
5. Criação das tabelas do banco.
6. Registro do primeiro administrador.
7. Ajustes iniciais e validação.

O exemplo considera o domínio exemplo.com.br. Troque esse endereço, o caminho do diretório e os dados do banco pelos valores do seu ambiente.

Quando vale a pena instalar WordPress pela linha de comando

O WP CLI é útil quando você tem acesso SSH e precisa de um processo reproduzível. Uma agência pode usar os mesmos passos para iniciar vários projetos. Uma equipe técnica também pode registrar os comandos em um manual operacional, reduzindo diferenças entre instalações.

A linha de comando não é obrigatoriamente a melhor escolha para um site único. Se a hospedagem oferece um instalador confiável e você não administra o servidor, use o painel. Ele reduz a chance de errar permissões ou configurar o servidor web no diretório incorreto.

O WP CLI também não substitui conhecimentos básicos de VPS. Se você ainda precisa criar banco, instalar PHP e configurar Nginx ou Apache, consulte primeiro o processo de instalação manual do WordPress. Esse conteúdo ajuda a entender as peças que ficam por trás dos comandos.

Pré requisitos para começar sem improviso

Antes de baixar o WordPress, confirme os seguintes itens:

1. Acesso SSH com um usuário administrativo.
2. WP CLI instalado e disponível no terminal.
3. Versão do PHP compatível com a versão atual do WordPress e com os plugins planejados.
4. Banco de dados criado ou credenciais com permissão para criá lo.
5. Nginx ou Apache configurado para servir o diretório do site.
6. Domínio definido e acesso à zona DNS.
7. Plano de backup ou imagem da VPS antes de alterações maiores.

Confira o WP CLI e o PHP com:

wp --info
php -v

O primeiro comando deve mostrar informações do WP CLI. O segundo deve informar a versão do PHP usada no terminal. Essa versão pode ser diferente da versão usada pelo servidor web. Se houver mais de uma instalação do PHP na VPS, confirme as duas antes de continuar.

Não execute todo o processo como root apenas para evitar erros de permissão. Use o usuário responsável pelos arquivos do site. O nome desse usuário varia conforme a configuração da VPS. Em muitos ambientes ele não é o mesmo usuário do servidor web.

Em uma VPS na LetsCloud, por exemplo, você pode aplicar este procedimento depois de preparar a pilha web e o acesso SSH. A escolha da VPS deve considerar memória, armazenamento, suporte disponível e sua capacidade de manter o sistema. Uma VPS pode ser trabalho desnecessário para quem só precisa publicar um site institucional pequeno.

Como instalar WordPress com WP CLI passo a passo

1. Crie e acesse o diretório do site

Escolha o caminho configurado como raiz do domínio no servidor web. Um exemplo comum é:

mkdir -p /var/www/exemplo.com.br/public
cd /var/www/exemplo.com.br/public

Não copie esse caminho sem conferir a configuração do Nginx ou Apache. Se o servidor estiver apontando para outra pasta, o navegador não encontrará a instalação.

Verifique também se o diretório está vazio. Baixar o WordPress sobre arquivos de outro projeto pode provocar perda de dados ou mistura de configurações.

2. Baixe o WordPress em português do Brasil

Dentro do diretório correto, execute:

wp core download --locale=pt_BR

Depois, confirme se arquivos como index.php, wp-load.php e a pasta wp-admin foram criados:

wp core verify-checksums

A verificação compara os arquivos do núcleo com as somas oficiais conhecidas pelo WP CLI. Ela não analisa temas, plugins nem arquivos enviados para a biblioteca de mídia.

3. Prepare o banco de dados

Você precisa do nome do banco, usuário, senha e endereço do servidor. Em uma VPS simples, o endereço costuma ser localhost, mas bancos externos usam outro host.

Crie o banco antes desta etapa pelo painel ou pelo administrador do banco. O comando wp db create também pode funcionar, mas somente quando o usuário informado tem permissão para criar bancos. Não conceda privilégios amplos ao usuário do WordPress apenas por conveniência.

O ideal é que cada site use um banco ou usuário próprio. Assim, uma credencial comprometida não oferece acesso imediato a todos os projetos hospedados no servidor.

4. Gere o arquivo de configuração

Use os dados reais do banco. O parâmetro de solicitação interativa evita escrever a senha diretamente no comando:

wp config create \
  --dbname=wordpress_exemplo \
  --dbuser=usuario_exemplo \
  --dbhost=localhost \
  --prompt=dbpass

Digite a senha quando o terminal solicitar. Em seguida, teste a conexão:

wp db check

Se o teste falhar, não avance. Confira nome do banco, usuário, senha, host, serviço do banco e permissões. Um erro de conexão nesta etapa não é corrigido pela reinstalação dos arquivos do WordPress.

5. Instale as tabelas e crie o administrador

Antes do comando final, escolha um nome de usuário que não seja admin. Defina também um endereço de email que a equipe realmente monitore.

Para evitar a exposição da senha no histórico, leia o valor de forma silenciosa e use uma variável temporária:

read -s WP_ADMIN_PASSWORD
wp core install \
  --url="https://exemplo.com.br" \
  --title="Site Exemplo" \
  --admin_user="gestor_site" \
  --admin_password="$WP_ADMIN_PASSWORD" \
  --admin_email="[email protected]" \
  --skip-email
unset WP_ADMIN_PASSWORD

O parâmetro --skip-email evita o envio do aviso inicial durante a preparação. Remova esse parâmetro se o envio de email já estiver configurado e testado.

Use uma URL com https somente quando o certificado estiver funcionando. Instalar com o protocolo errado e corrigir depois é possível, mas exige mais testes e pode deixar referências antigas no banco.

6. Confirme os dados básicos

Verifique a versão instalada, a URL principal e os usuários:

wp core version
wp option get home
wp option get siteurl
wp user list

A lista de usuários deve mostrar apenas as contas esperadas. Se você executou o comando mais de uma vez ou reutilizou um banco antigo, pare e revise o ambiente antes de publicar.

Como preparar domínio, DNS e SSL na VPS

A instalação do WordPress não aponta o domínio automaticamente. O registro DNS precisa direcionar o domínio ao endereço correto do servidor. Mudanças de DNS podem levar algum tempo para aparecer em diferentes redes.

Use o guia sobre como apontar um domínio para WordPress para conferir registros e evitar alterações desnecessárias. Só emita o certificado depois que o domínio estiver chegando à VPS correta.

O SSL também depende da configuração do servidor web. Depois de ativá lo, teste a página inicial, a área administrativa e arquivos de mídia. O guia de configuração de SSL no WordPress detalha os cuidados para evitar redirecionamentos em ciclo e conteúdo carregado por endereço inseguro.

Se o domínio ainda não estiver disponível, você pode preparar arquivos e banco sem abrir o site ao público. Evite trocar repetidamente a URL principal entre endereço IP, domínio temporário e domínio definitivo. Essa prática pode espalhar referências antigas no banco.

Como validar a instalação antes de publicar

Abra o endereço do site em uma janela privativa e faça testes como visitante. Depois, entre em /wp-admin/ com a conta criada.

Confira:

1. Página inicial sem erro do servidor.
2. Login administrativo funcionando.
3. Biblioteca de mídia aceitando um arquivo de teste.
4. Links permanentes salvando sem erro.
5. Idioma e fuso horário corretos.
6. Certificado válido no domínio principal e na variação escolhida com ou sem www.
7. Envio de email testado antes de usar formulários ou recuperação de senha.
8. Backup executado e restauração documentada.

Também rode:

wp core verify-checksums
wp db check
wp cron event list

A presença de eventos agendados é normal. O objetivo é identificar erros evidentes e confirmar que o WP CLI consegue ler a instalação.

Erros comuns ao instalar WordPress com WP CLI

Executar comandos no diretório errado

O WP CLI pode informar que não encontrou uma instalação ou pode atuar sobre outro site. Execute pwd antes de comandos que alteram banco, plugins ou opções.

Usar root e corrigir tudo com permissões amplas

Permissões como 777 escondem o problema em vez de resolvê lo. Descubra qual usuário deve possuir os arquivos e qual grupo atende ao servidor web. A regra depende da arquitetura adotada.

Deixar senhas no histórico

Senhas passadas diretamente como argumentos podem permanecer no histórico e aparecer em processos do sistema. Prefira solicitações interativas, variáveis temporárias e um gerenciador de segredos adequado à operação.

Configurar HTTPS antes do certificado funcionar

Se o servidor não responde corretamente por HTTPS, o painel pode ficar inacessível. Valide DNS, servidor web e certificado antes de gravar a URL definitiva.

Reutilizar um banco sem confirmar seu conteúdo

Um banco antigo pode conter usuários, plugins, opções e URLs de outro projeto. Use um banco vazio para uma instalação nova. Faça backup antes de apagar qualquer tabela.

Instalar plugins antes de validar o núcleo

Teste primeiro o WordPress limpo. Instale apenas os plugins necessários, um grupo pequeno por vez. Isso facilita descobrir a origem de erros.

Checklist final da instalação

Antes de liberar o site, confirme:

1. WP CLI funciona com o usuário operacional.
2. Arquivos do núcleo passaram pela verificação.
3. Banco usa credenciais exclusivas e permissões limitadas.
4. A conta administrativa não usa nome previsível.
5. DNS aponta para a VPS correta.
6. SSL funciona sem avisos no navegador.
7. URLs home e siteurl estão corretas.
8. Login, mídia e links permanentes foram testados.
9. Email transacional foi validado.
10. Backup inicial foi criado.
11. Processo de atualização e manutenção foi definido.

Perguntas frequentes sobre instalação com WP CLI

Preciso saber programar para usar o WP CLI?

Não é necessário desenvolver um plugin, mas você precisa compreender terminal, diretórios, usuários, permissões e banco de dados. Se esses conceitos ainda forem novos, use um ambiente de teste.

Posso executar o WP CLI como root?

O WP CLI permite operações em diferentes contextos, mas usar root como padrão pode criar arquivos com proprietário inadequado e ampliar o impacto de um erro. Prefira um usuário operacional com apenas as permissões necessárias.

O WP CLI substitui o painel da hospedagem?

Não. Ele administra o WordPress e algumas tarefas relacionadas ao banco. DNS, certificado, firewall, recursos da VPS e configuração do servidor web continuam fora do núcleo do WordPress.

Posso instalar WordPress antes de apontar o domínio?

Você pode preparar arquivos e banco, mas a instalação final deve usar uma URL planejada. Evite publicar conteúdo antes de confirmar o domínio definitivo e o HTTPS.

Como instalar vários sites sem repetir todos os comandos?

É possível criar um script ou usar uma ferramenta de automação. Comece documentando um processo manual confiável. Depois, substitua dados fixos por variáveis e nunca grave senhas no arquivo de automação.

Próximos passos depois da instalação

Com o WordPress funcionando, evite começar pelo excesso de temas e plugins. Primeiro defina idioma, fuso horário, links permanentes, usuários, backup e rotina de atualização.

Em seguida, aplique o checklist de SEO básico para um site WordPress novo. Ele ajuda a revisar visibilidade nos mecanismos de busca, estrutura inicial e configurações que costumam ser esquecidas durante a montagem do site.