Hospedagem para WordPress na VPS: primeiro acesso e primeiros passos

A Hospedagem para WordPress já vem com o WordPress instalado em português do Brasil, com banco de dados próprio (MariaDB) e HTTPS. É só entrar no painel e começar a montar o seu site.

O que vale para todos os aplicativos (SSH, log, reiniciar) está no artigo Sua VPS com aplicativo: dados de acesso, onde fica cada coisa, ver o log, reiniciar o app.

Primeiro acesso

1. Abra o painel do WordPress: https://site.SEU-IP.yhostbr.online/wp-admin (o IP da VPS com traços no lugar dos pontos).
2. No login, use o e-mail do seu cadastro na yHost ou o nome de usuário que veio no e-mail (ele começa com admin-). A senha é a que veio no e-mail.

O site em si fica em https://site.SEU-IP.yhostbr.online. Ele já nasce com o título "Meu site", o fuso horário de São Paulo, datas no formato dia/mês/ano e links amigáveis (o endereço de cada página usa o nome dela).

Trocar a senha

1. No menu da esquerda do painel, clique em Usuários > Perfil.
2. Desça até Gerenciamento de conta e clique em Definir nova senha.
3. O campo Nova senha aparece já com uma senha forte sugerida pelo WordPress. Você pode usar essa (guarde num lugar seguro) ou apagar e digitar a sua. Se a sua for fraca, o WordPress pede para marcar Confirmar o uso de uma senha fraca: prefira uma senha forte.
4. Clique em Atualizar perfil, no fim da página.

Primeiros passos

Dar nome ao site

Em Configurações > Geral, troque o Título do site (ele vem como "Meu site") e a Descrição. Clique em Salvar alterações.

Escolher a aparência

Em Aparência > Temas ficam os temas instalados. Para buscar outro, clique em Adicionar tema, escolha um, clique em Instalar agora e depois em Ativar.

Criar as primeiras páginas

Em Páginas > Adicionar página, escreva o título e o conteúdo e clique em Publicar. Se o WordPress pedir confirmação, clique em Publicar de novo.

Instalar plugins

Plugins acrescentam funções ao site, como um formulário de contato. Em Plugins > Adicionar plugin, procure pelo nome no campo Pesquisar plugins, clique em Instalar agora e depois em Ativar. Instale só os plugins de que você precisa e mantenha todos atualizados.

Enquanto o site está em construção

Para pedir aos buscadores, como o Google, que não mostrem o site antes de ele ficar pronto, vá em Configurações > Leitura e, em Visibilidade nos motores de busca, marque Evitar que mecanismos de busca indexem este site. Clique em Salvar alterações. Quando o site for ao ar, desmarque essa opção.

O site não envia e-mail

A VPS não vem com envio de e-mail configurado. Por isso, mensagens de formulários de contato, avisos do WordPress e o link "Perdeu a senha?" não chegam. Para resolver, instale um plugin de SMTP (procure por "SMTP" em Plugins > Adicionar plugin) e configure nele uma conta de e-mail sua.

Usar o seu próprio domínio (avançado)

O site nasce no endereço site.SEU-IP.yhostbr.online. Para usar um domínio seu, como www.seudominio.com.br, siga os passos nesta ordem. Eles valem para um endereço só (por exemplo, com www).

1. Onde fica o DNS do seu domínio, crie um registro do tipo A para www.seudominio.com.br apontando para o IP da VPS. Espere ele começar a valer: pode levar de alguns minutos a algumas horas.
2. Entre na VPS pelo SSH e abra o arquivo /opt/yhost/wordpress/.env. Na linha WP_HOST=, troque o endereço pelo seu domínio, sem https:// (exemplo: WP_HOST=www.seudominio.com.br), e salve.
3. Aplique a mudança:

   cd /opt/yhost/wordpress
   docker compose up -d

   O certificado HTTPS do domínio novo sai sozinho em alguns minutos. A partir daqui, o endereço antigo deixa de abrir o site.
4. Troque o endereço dentro do WordPress (use o seu IP com traços e o seu domínio):

   docker compose run --rm wpcli wp search-replace 'https://site.SEU-IP.yhostbr.online' 'https://www.seudominio.com.br' --skip-columns=guid

5. Entre no painel pelo endereço novo: https://www.seudominio.com.br/wp-admin.

Onde roda na VPS

WP-CLI, a linha de comando do WordPress (avançado)

O kit traz o WP-CLI pronto para usar pelo SSH. Os comandos rodam a partir da pasta do site:

cd /opt/yhost/wordpress
docker compose run --rm wpcli wp plugin list

Troque wp plugin list pelo comando que quiser. Exemplo útil: definir uma senha nova quando você esqueceu a sua (troque o usuário e a senha):

cd /opt/yhost/wordpress
docker compose run --rm wpcli wp user update admin-xxxxx --user_pass='SuaNovaSenhaForte'

Problemas comuns

A página não abre logo depois da criação

A instalação leva de 2 a 6 minutos depois que a VPS liga. Espere uns 10 minutos e tente de novo numa janela anônima. Para acompanhar, veja o log da instalação pelo SSH: tail -n 30 /var/log/yhost-app.log.

O navegador avisa que a conexão não é segura

O certificado HTTPS ainda não saiu. Ele costuma sair poucos minutos depois da instalação e, se o endereço da VPS demorou a ficar pronto, o sistema tenta de novo sozinho a cada 10 minutos. Espere e recarregue a página. Enquanto o aviso aparecer, não digite sua senha. Se o aviso continuar depois de 1 hora, abra um chamado.

Esqueci a senha

Se você ainda não trocou a senha, a original está na VPS, no arquivo /root/yhost-app.txt (use cat /root/yhost-app.txt). Se já trocou, defina uma nova pelo WP-CLI, como no exemplo acima. O link "Perdeu a senha?" depende de e-mail, que não vem configurado.

O arquivo é grande demais para enviar

O limite é de 128 MB por arquivo. Para mudar, edite pelo SSH o arquivo /opt/yhost/wordpress/php-yhost.ini (linhas upload_max_filesize e post_max_size) e depois rode docker compose restart dentro de /opt/yhost/wordpress.

Precisa de ajuda?

Abra um chamado em https://yhost.com.br/painel/suporte. Informe o IP da VPS e o que aconteceu. Se tiver uma mensagem de erro, mande um print.