Trocar a senha do banco de dados sem derrubar o site
O passo a passo no cPanel e no arquivo de configuração, na ordem que reduz o tempo fora do ar ao tempo de copiar e colar. Sem terminal, sem comando.

Resposta curta: trocar a senha do banco de dados é uma tarefa de 2 etapas que precisam acontecer na mesma janela: definir a senha nova no painel da hospedagem e colar essa mesma senha no arquivo de configuração do site. Entre uma e outra, o site mostra "Erro ao estabelecer conexão com o banco de dados".
Neste artigo
- O que é o usuário do banco de dados, e por que você nunca digita essa senha
- Por que a ordem importa e por que existe um intervalo fora do ar
- O que ter em mãos antes de começar, sem linha de comando
- Trocar a senha no painel da hospedagem
- Colar a senha nova no arquivo de configuração do site
- O que significa "Erro ao estabelecer conexão com o banco de dados"
- Quando o erro continua depois de você trocar tudo
- O que mais pode estar usando a mesma senha do banco
- O que fazer depois que o site voltar ao ar
Um site feito em WordPress, Joomla, Drupal ou qualquer sistema parecido tem duas partes. Os arquivos, que ficam na hospedagem como ficam numa pasta do computador. E o banco de dados, que guarda os textos, os comentários, os pedidos da loja e a lista de usuários.
O site precisa de uma senha para abrir esse banco de dados. Essa senha não fica na sua cabeça nem no seu gerenciador de senhas: ela fica escrita dentro de um arquivo do próprio site. É por isso que trocar a senha do banco é uma tarefa dupla. Você muda em um lugar e precisa avisar o outro.
Quando alguém faz só metade, o site fica fora do ar com a mensagem "Erro ao estabelecer conexão com o banco de dados". Não é invasão. Não é servidor caído. É o site batendo na porta com a chave antiga.
Este guia é documental. Ele segue a documentação oficial do cPanel e a estrutura conhecida dos arquivos de configuração. Não há medição de laboratório aqui, não cronometramos nada para escrever este texto. Todas as senhas e nomes que aparecem nos exemplos são fictícios.
O que é o usuário do banco de dados, e por que você nunca digita essa senha
Pense na hospedagem como um terreno. O site é a casa construída nesse terreno. O banco de dados é um arquivo trancado dentro da casa, com todo o conteúdo escrito.
O usuário do banco de dados é o crachá que abre esse arquivo. Ele tem um nome (algo como exemplo_wp1) e uma senha. Quem usa esse crachá é o próprio site, automaticamente, várias vezes por segundo, a cada visita de alguém.
Você nunca digita essa senha para entrar em lugar nenhum. Ela existe só para o site conversar com o banco.
Isso causa uma confusão muito comum em quem está começando: a pessoa acha que tem uma senha só. Na verdade são quatro senhas diferentes, que vivem em lugares diferentes.
| Senha | Onde você a usa | O que ela abre |
|---|---|---|
| Senha da conta de hospedagem (cPanel) | Para entrar no painel de controle da hospedagem | Arquivos, e-mails, bancos, tudo da conta |
| Senha do usuário do banco de dados | Você não digita, quem usa é o site | O conteúdo do site (textos, pedidos, usuários) |
| Senha de administrador do WordPress | Tela de login do seu site, normalmente em /wp-admin |
O painel de edição do site |
| Senha da conta de e-mail | Webmail, celular, Outlook | Só aquela caixa de e-mail |
Trocar uma não troca as outras. Este artigo trata só da segunda linha da tabela.
Quando vale trocar essa senha, e quando não vale
- O desenvolvedor ou a agência que cuidava do site saiu, e a senha antiga está no computador de alguém que não trabalha mais com você.
- Houve suspeita de invasão e você está trocando tudo que pode ser trocado.
- A senha foi enviada por WhatsApp, e-mail ou chat para várias pessoas ao longo dos anos.
- Alguém pediu a senha do banco e você não sabe mais quem tem acesso.
Se nenhum desses casos é o seu, e o site está funcionando, não há motivo para trocar. Senha de banco não vence.
Por que a ordem importa e por que existe um intervalo fora do ar
Aqui está o ponto que quase ninguém explica.
No instante em que você define a senha nova no painel, a senha antiga deixa de valer. O arquivo do site, porém, continua com a senha antiga escrita dentro dele. Entre um momento e o outro, o site mostra o erro de conexão.
Não dá para fugir desse intervalo. Se você editar o arquivo primeiro, escrevendo a senha nova antes de ela existir, o site quebra do mesmo jeito. O intervalo é inevitável nas duas ordens.
O que dá para controlar é o tamanho dele. Feito com calma e com as duas abas do navegador já abertas, o intervalo dura o tempo de copiar e colar. Feito de qualquer jeito, procurando o arquivo depois de já ter trocado a senha, o mesmo intervalo se estica pelo tempo todo que você levar para achar o arquivo.
A ordem recomendada é esta:
- Escolha a senha nova e guarde num lugar seguro.
- Ache o arquivo de configuração e guarde uma cópia dele antes de mexer.
- Abra o arquivo no editor, mas ainda não salve nada.
- Troque a senha no painel.
- Cole a senha nova no arquivo e salve.
- Recarregue o site.
Os passos 1, 2 e 3 são preparação e não derrubam nada. O relógio só começa a correr no passo 4.
O que ter em mãos antes de começar, sem linha de comando
Tenha isto em mãos:
- Acesso ao painel da hospedagem. Normalmente o cPanel, que é a tela onde você administra a hospedagem. O endereço costuma ser algo como
seusite.com.br/cpanel, e o login veio no e-mail de ativação da conta. - Um backup recente do site. Se a hospedagem tem backup automático, confirme a data do último. Se não tem, gere um antes.
- Vinte minutos sem pressa. Não faça isso no horário de pico da sua loja.
- Saber qual sistema seu site usa. WordPress, Joomla, Drupal, uma loja, um sistema feito sob medida. Se não souber, pergunte a quem construiu o site, ou olhe a tabela da seção sobre arquivos de configuração e veja qual arquivo existe na sua hospedagem.
Uma coisa que você não precisa: linha de comando. Existem formas técnicas de mexer nos arquivos, como o SSH (uma janela preta onde se digitam comandos no servidor) e o FTP (um programa que transfere arquivos entre o seu computador e a hospedagem). Nenhuma delas é necessária aqui. Tudo neste guia se faz clicando, dentro do navegador.
Como escolher a senha nova e por que evitar aspas e cifrão
Use o gerador de senhas do próprio painel, que costuma aparecer ao lado do campo. Ele cria senhas longas e aleatórias, e você não vai precisar decorar nenhuma delas.
Uma ressalva prática: senhas com aspas simples, aspas duplas, barra invertida ou cifrão podem atrapalhar na hora de colar dentro do arquivo de configuração, porque esses caracteres têm significado especial ali. Uma senha longa feita só de letras e números resolve o problema sem perder segurança. Comprimento vale mais que símbolo exótico.
Trocar a senha no painel da hospedagem
Um aviso sobre nomes: o banco de dados fica guardado por um programa, e os mais comuns em hospedagem se chamam MySQL, MariaDB e PostgreSQL. Para o que você vai fazer aqui, os três funcionam do mesmo jeito. O nome importa só para você reconhecer o menu certo dentro do painel.
Como trocar no cPanel, o painel de quem tem o site
O caminho abaixo descreve a interface padrão do cPanel. Os nomes dos menus e a posição dos botões podem variar conforme a versão e o tema que a sua hospedagem usa, mas a sequência é sempre a mesma: achar a área de bancos de dados, achar o usuário, trocar a senha.
- Entre no cPanel com o login da sua conta de hospedagem.
- Procure a seção Bancos de Dados (ou *Databases*) e abra Bancos de Dados MySQL (*MySQL Databases*).
- Role a página até a lista de Usuários atuais (*Current Users*). Você vai ver os nomes dos usuários do banco existentes na conta, no formato
conta_nome. - Ao lado do usuário que o seu site utiliza, clique na opção de alterar a senha.
- Digite a senha nova duas vezes, ou clique em gerar senha e copie o que o painel criou.
- Confirme.
Resultado esperado: o painel mostra uma mensagem de sucesso. E o seu site, a partir de agora, mostra o erro de conexão. Isso é esperado, e é justamente por isso que o próximo passo precisa vir em seguida.
Se você não souber qual dos usuários da lista é o do seu site, não adivinhe. O nome do usuário está escrito dentro do arquivo de configuração, na linha logo acima da senha. Abra o arquivo antes (passo 2 da seção seguinte), leia o nome, e só então volte aqui.
Como trocar no WHM, e o que essa tela não faz por você
Quem tem servidor dedicado, um VPS (um servidor só seu, alugado por mês) com WHM, ou uma conta de revenda, também pode fazer a troca por outro caminho. A documentação oficial do cPanel descreve a interface Change Database User Password, usada pelo administrador do servidor para alterar a senha de um usuário de banco de dados: ela pede o nome do usuário e a nova senha, conforme a documentação do cPanel.
Preste atenção a um detalhe que essa documentação deixa claro pelo que ela não faz: a interface troca a senha do usuário do banco e só. Ela não sai procurando os arquivos dos sites para atualizá-los. Essa parte continua sendo manual, e é a próxima seção.
Colar a senha nova no arquivo de configuração do site
Cada sistema guarda os dados de conexão num arquivo próprio. Na maioria das hospedagens, esse arquivo fica dentro da pasta principal do site, aquela onde ficam os arquivos que respondem quando alguém digita o seu endereço no navegador. Essa pasta costuma se chamar public_html, e é o que os manuais chamam de raiz do site. Sempre que você ler "raiz" daqui para a frente, pense em public_html.
| Sistema | Arquivo | Onde costuma ficar | Linha da senha |
|---|---|---|---|
| WordPress | wp-config.php |
Na raiz do site, ou seja, direto dentro de public_html |
DB_PASSWORD |
| Joomla | configuration.php |
Na raiz do site, direto dentro de public_html |
public $password |
| Drupal | settings.php |
Numa subpasta, em sites/default/ |
item password dentro de $databases |
Se o seu site foi feito sob medida por um programador, o arquivo pode ter outro nome e, em alguns casos, ficar fora da pasta pública, um nível acima de public_html. Nesse cenário, pergunte a quem construiu o site onde está o arquivo em vez de sair procurando.
Como guardar uma cópia do arquivo antes de editar
Duas opções, as duas dentro do navegador. A mais simples é baixar o arquivo para o seu computador.
Opção recomendada, cópia no seu computador:
- No cPanel, abra o Gerenciador de Arquivos (*File Manager*).
- Entre na pasta
public_html. Se você tem mais de um site na mesma conta, entre na pasta do site certo. - Clique uma vez no arquivo de configuração para selecioná-lo.
- Clique em Baixar (*Download*), no menu de cima. O arquivo vai para a pasta de downloads do seu computador.
Resultado esperado: um arquivo com o mesmo nome (wp-config.php, por exemplo) salvo no seu computador, exatamente como ele está hoje no servidor. Não abra esse arquivo baixado com dois cliques, porque o computador pode tentar executá-lo ou abri-lo num programa que altera o conteúdo. Ele fica ali guardado, e pronto.
Opção alternativa, cópia dentro da própria hospedagem:
- Selecione o arquivo e clique em Copiar (*Copy*).
- O painel abre uma caixa pedindo o caminho de destino, já preenchido com a pasta em que você está (algo como
/home/suaconta/public_html). - Esse campo aceita tanto o caminho de uma pasta quanto um caminho terminado com um nome de arquivo. Se você quiser a cópia na mesma pasta, complete o caminho com um nome novo, por exemplo
/home/suaconta/public_html/wp-config-backup.php. Se preferir guardar a cópia em outro lugar, informe a pasta de destino e deixe que ela mantenha o nome original. - Confirme em Copiar arquivo(s) (*Copy File(s)*).
Resultado esperado: o arquivo original continua no lugar, funcionando, e ao lado dele (ou na outra pasta) aparece a cópia. Não é preciso renomear nada antes nem depois.
Qualquer uma das duas serve. O importante é ter, em algum lugar, o conteúdo original do arquivo, e lembrar onde você o deixou e com que nome.
Como abrir o arquivo pelo navegador, sem instalar nada
- Ainda no Gerenciador de Arquivos, clique com o botão direito no arquivo original.
- Escolha Editar (*Edit*).
- Se aparecer um aviso sobre codificação de caracteres, pode confirmar e seguir.
Resultado esperado: uma tela de texto simples, dentro do navegador, com o conteúdo do arquivo.
Qual linha do arquivo mudar, e por que só ela
No WordPress, o trecho se parece com isto (nome, usuário e senha abaixo são fictícios, os seus serão diferentes):
define( 'DB_NAME', 'exemplo_site' );
define( 'DB_USER', 'exemplo_wp1' );
define( 'DB_PASSWORD', 'senhaAntiga123' );
define( 'DB_HOST', 'localhost' );
Você mexe em uma linha só: a do DB_PASSWORD. Apague o que está entre as aspas e cole a senha nova ali dentro. As aspas continuam. O ponto e vírgula no fim continua. Nada mais muda.
No Joomla, a linha equivalente é public $password = 'senhaAntiga123';. A lógica é idêntica: trocar só o texto entre as aspas.
Salve. Recarregue o site.
Resultado esperado: o site volta ao normal, imediatamente, sem precisar reiniciar nada. Se voltou, acabou. Você pode apagar a cópia de segurança depois de alguns dias.
O que significa "Erro ao estabelecer conexão com o banco de dados"
Essa frase, ou a versão em inglês *Error establishing a database connection*, significa uma coisa só: o site tentou abrir o banco de dados e não conseguiu.
Ela não significa que o site foi invadido. Não significa que seus arquivos sumiram. Não significa que o conteúdo foi apagado. O texto do seu site continua inteiro dentro do banco, do outro lado da porta.
As causas mais comuns, em ordem de probabilidade quando você acabou de mexer na senha:
- A senha no arquivo não é a mesma que você definiu no painel. Erro de digitação, espaço colado junto, caractere trocado.
- Você editou o arquivo errado, de outro site ou de uma instalação antiga que ficou numa subpasta.
- O usuário certo existe e a senha está certa, mas esse usuário não está associado ao banco de dados. Isso acontece quando alguém cria um usuário novo em vez de trocar a senha do existente.
- O servidor de banco de dados está indisponível. Aí não é a senha, e o erro apareceria mesmo sem você ter mexido em nada.
Se o site voltou depois de você corrigir a senha, era a causa 1. Se não voltou, siga para a próxima seção.
Quando o erro continua depois de você trocar tudo
Confira a senha caractere por caractere, inclusive o espaço no fim
O jeito mais seguro de não errar é não digitar. Copie do gerador de senhas, cole no painel, cole no arquivo. E preste atenção em espaço em branco no começo ou no fim: ao selecionar com o mouse, é fácil levar um espaço junto, e o espaço conta como parte da senha.
Um teste simples: volte ao painel e defina a senha de novo, colando exatamente o mesmo texto que está entre as aspas no arquivo. Se as duas pontas receberem o mesmo conteúdo colado, elas batem.
Confirme que o arquivo editado é o do site que está no ar
Contas com vários sites acumulam pastas. Existem instalações antigas em public_html/site-velho, cópias de teste, e todas têm um wp-config.php parecido. Confirme pelo endereço: se o site que está fora do ar é o domínio principal, o arquivo certo está direto dentro de public_html, sem entrar em nenhuma subpasta.
Verifique se o usuário está associado ao banco de dados
Na mesma tela de Bancos de Dados MySQL do cPanel existe uma seção que mostra quais usuários estão associados a quais bancos. Se o usuário do seu arquivo não aparece ligado ao banco do seu arquivo, o site nunca vai conectar, por mais correta que a senha esteja.
Para ligar os dois, sem sair do navegador:
- Na mesma página Bancos de Dados MySQL, role até a seção Adicionar usuário ao banco de dados (*Add User To Database*).
- Na primeira lista, escolha o usuário. É o nome que está escrito na linha
DB_USERdo seu arquivo. - Na segunda lista, escolha o banco de dados. É o nome que está na linha
DB_NAME. - Clique em Adicionar (*Add*).
- A página seguinte mostra uma lista de permissões. Marque a caixa TODOS OS PRIVILÉGIOS (*ALL PRIVILEGES*), que marca todas as outras de uma vez.
- Clique em Fazer alterações (*Make Changes*).
Resultado esperado: o painel confirma a alteração e, ao voltar para a lista de bancos de dados, o nome do usuário aparece listado embaixo do banco. Recarregue o site: se a senha do arquivo estava certa, ele volta agora.
Esse é um problema diferente do da senha, e ele costuma aparecer com uma mensagem de acesso negado nos registros de erro do site.
Como restaurar a cópia do arquivo, e por que ela sozinha não resolve
Se você mexeu demais e não sabe mais o que mudou, recupere o arquivo original. O caminho depende de onde você deixou a cópia.
Se a cópia está no seu computador: no Gerenciador de Arquivos, dentro da pasta do site, clique em Carregar (*Upload*), escolha o arquivo baixado e confirme a substituição do que está lá. O nome é o mesmo, então nada mais precisa ser feito.
Se a cópia está em outra pasta do servidor, com o nome original: apague o arquivo editado, entre na pasta onde está a cópia, selecione-a e use Copiar (*Copy*) ou Mover (*Move*) informando como destino a pasta do site. Como o nome já é o certo, o site volta a encontrar o arquivo.
Se a cópia está na mesma pasta, com outro nome (wp-config-backup.php, no exemplo da seção anterior): apague o arquivo editado e depois clique em Renomear (*Rename*) na cópia, mudando o nome para wp-config.php. Sem essa renomeação o site continua sem funcionar, porque ele procura o arquivo pelo nome exato e wp-config-backup.php não serve.
Um aviso importante para não criar falsa expectativa: isso sozinho não põe o site no ar. A cópia tem a senha antiga escrita dentro dela, e a senha antiga já deixou de valer no momento em que você a trocou no painel. O site continua mostrando o erro de conexão.
O que essa restauração faz é devolver um arquivo limpo, sem as edições atrapalhadas. A partir dele, faça assim, sem pressa:
- Volte ao painel e defina a senha do usuário do banco de novo, usando o gerador.
- Copie a senha gerada.
- Abra o arquivo restaurado e cole a senha na linha da senha, entre as aspas.
- Salve e recarregue o site.
É exatamente por isso que o passo da cópia vem antes de tudo: ele não cura o erro, mas garante que você sempre tenha um arquivo íntegro para recomeçar.
O que mais pode estar usando a mesma senha do banco
A parte que pega gente experiente: o site principal não é sempre o único que fala com aquele banco.
Vale checar, depois que o site voltou ao ar:
- Outros sites ou subdomínios (subdomínio é um endereço que nasce dentro do seu endereço principal, como
loja.seusite.com.broublog.seusite.com.br) que compartilham o mesmo banco de dados. Cada um tem seu próprio arquivo de configuração e cada um precisa da senha nova. - Tarefas agendadas (cron), que rodam sozinhas de madrugada para gerar relatório, sincronizar estoque ou limpar dados. Se alguma delas tem a senha escrita dentro, ela vai falhar em silêncio.
- Aplicativo de celular ou sistema interno que lê o mesmo banco.
- Ferramentas de backup ou de migração configuradas com o usuário do banco.
- Um programa de acesso ao banco instalado no computador, que você ou o desenvolvedor usem para consultar os dados de fora do site.
A forma prática de descobrir esses casos é esperar alguns dias e ver o que parou de funcionar. Não é elegante, mas é honesto: quem herda um site não tem o inventário de quem o construiu.
O que fazer depois que o site voltar ao ar
Guarde a senha nova num gerenciador de senhas, não num bloco de notas do computador nem num e-mail para você mesmo. Você não vai usá-la no dia a dia, mas vai precisar dela em qualquer migração futura.
Se o motivo da troca foi a saída de um desenvolvedor ou uma suspeita de invasão, a senha do banco é uma das portas, não a única. Vale trocar também a senha da conta de hospedagem, as senhas de administrador do site, as senhas de FTP (aquele programa de transferência de arquivos citado lá atrás) e as contas de e-mail. Cada uma na sua tela, cada uma com sua senha própria, como na tabela do começo deste texto.
E se em algum momento o site voltar a mostrar o erro de conexão sem ninguém ter tocado em senha nenhuma, aí a investigação muda de lugar: o problema provavelmente não está no arquivo, e sim no servidor de banco de dados. Nesse caso, abrir chamado com a hospedagem é o caminho mais curto.
Referências
- Documentação oficial (cpanel) — Change Database User Password. Consultado em 2026-09-24.