# O instalador pede banco, usuário, senha e host: o que colocar

Dois detalhes derrubam a instalação na primeira tentativa: o prefixo que o painel adiciona sozinho e a associação entre usuário e banco. Veja onde cada valor nasce e onde anotá-lo.

> os três primeiros campos você cria no painel da hospedagem, pelo assistente de banco de dados, e o quarto quase sempre é localhost. O nome do banco e o do usuário levam o prefixo da sua conta na frente, e o usuário precisa ser associado ao banco.

João Rizzon · 2026-11-09 · Painéis

---

Você baixou um sistema (WordPress, Moodle, uma loja virtual) e, logo no começo da instalação, apareceu uma tela pedindo quatro coisas: nome do banco de dados, nome de usuário do banco, senha e host. Nenhuma delas você escolheu ainda. Elas não vêm prontas: você precisa criar as três primeiras dentro do painel da sua hospedagem, anotar e só depois voltar e colar.

Este guia mostra exatamente isso, usando o assistente do cPanel (o painel de controle mais comum em hospedagem compartilhada). Sem terminal, sem comando. Só cliques e um papel do lado para anotar.

## O que é um banco de dados, em linguagem de gente

Seu site tem duas partes que moram em lugares diferentes do mesmo servidor.

A primeira parte são os **arquivos**: as imagens, o visual, o programa em si. Pense em uma casa montada.

A segunda parte é o **banco de dados**: o armário onde ficam guardados os textos dos seus posts, os pedidos da loja, os cadastros de usuários, as configurações. Pense em um armário de aço com gavetas, dentro da casa.

O instalador está perguntando: qual gaveta eu uso, quem tem a chave dessa gaveta, qual é a chave, e em que endereço fica o armário.

Por isso são três coisas separadas e não uma só:

- **Banco de dados**: o armário em si, onde os dados ficam.
- **Usuário do banco**: a pessoa autorizada a abrir aquele armário. É diferente do seu login no painel e diferente do login do seu site.
- **Senha**: a chave dessa pessoa.

E falta um detalhe que derruba quase todo iniciante: criar o armário e criar a pessoa não faz a pessoa ter a chave. É preciso um terceiro passo, o de **associar** o usuário ao banco e dar permissão. Quem pula esse passo recebe erro de conexão mesmo com a senha digitada corretamente.

## O que ter em mãos antes de começar

- Acesso ao painel da hospedagem (normalmente em `seudominio.com.br/cpanel` ou pelo link que a hospedagem enviou por e-mail).
- A tela do instalador aberta em outra aba, ou anotado onde ela está.
- Um bloco de notas aberto. Você vai anotar quatro linhas e vai precisar delas de novo no futuro, quando for fazer backup ou mudar de servidor.
- Cerca de cinco minutos.

Não feche o painel no meio do caminho. O assistente mostra o nome completo do banco em uma tela só, e é esse nome completo que você precisa copiar.

## Por que o prefixo da conta quebra a instalação

Esta é a parte que ninguém avisa.

Quando você digita `loja` como nome do banco, o cPanel **não** cria um banco chamado `loja`. Ele cria um banco com o nome da sua conta de hospedagem na frente, separado por underline. Se a sua conta se chama `napoleo1`, por exemplo, o banco vira `napoleo1_loja`.

A mesma coisa acontece com o usuário. Você digita `admin`, o painel cria `napoleo1_admin`.

Isso acontece porque o servidor é compartilhado: várias contas convivem nele, e dois clientes poderiam querer um banco chamado `loja`. O prefixo garante que cada nome seja único. A [documentação oficial do cPanel](https://docs.cpanel.net/cpanel/databases/database-wizard/120/) descreve esse comportamento e avisa que o prefixo conta no limite de caracteres do nome, então nomes curtos evitam dor de cabeça.

O erro clássico: a pessoa cria o banco, volta para o instalador e digita `loja` e `admin`. O servidor responde que não existe. Existe, mas com o prefixo.

**Regra prática:** copie o nome que aparece na tela do painel, com prefixo e tudo. Nunca digite de memória.

## Criando banco, usuário e senha pelo assistente do cPanel

O cPanel tem duas ferramentas para banco de dados. Os nomes delas trazem a palavra MySQL: é o programa que guarda e organiza os dados, o tipo de banco usado pela maioria das hospedagens. A ferramenta completa chama-se **MySQL Databases** (Bancos de Dados MySQL). A guiada chama-se **MySQL Database Wizard** (Assistente de Banco de Dados MySQL). Use a guiada: ela força a sequência certa e não deixa você esquecer a associação.

### Abra o Assistente de Banco de Dados MySQL

No painel, procure a seção **Bancos de Dados** e clique em **Assistente de Banco de Dados MySQL** (MySQL Database Wizard).

Resultado esperado: uma tela com um campo único, chamado algo como "Novo Banco de Dados", já com o prefixo da sua conta aparecendo cinza à esquerda.

### Nomeie o banco e copie o nome com prefixo

Digite um nome curto, só com letras minúsculas e sem acento, espaço ou símbolo. Exemplos que funcionam bem: `site`, `loja`, `blog`.

Clique em **Próxima Etapa**.

Resultado esperado: uma mensagem de confirmação mostrando o nome completo, já com prefixo. **Copie esse nome inteiro para o bloco de notas agora.**

### Crie o usuário e gere a senha sem símbolos

A tela seguinte pede nome de usuário e senha. O prefixo aparece de novo, pelo mesmo motivo.

Use o **Gerador de Senhas** do próprio painel. Antes de clicar em gerar, abra as opções avançadas do gerador e deixe marcadas apenas letras e números, desmarcando os símbolos. Se o seu painel não oferecer essa opção, gere a senha e apague manualmente os símbolos que aparecerem (`@`, `#`, `$`, `%`, aspas), completando com letras e números até ter cerca de 16 caracteres. Copie e cole no bloco de notas antes de continuar, porque a senha não fica visível depois.

O motivo de evitar esses símbolos: alguns instaladores leem mal esses caracteres no arquivo de configuração e você recebe um erro de acesso negado sem entender o motivo. Letras e números, 16 caracteres, já é uma senha forte.

Clique em **Criar Usuário**.

### Associe o usuário ao banco com todos os privilégios

Esta é a etapa que não pode ser pulada. O assistente mostra uma lista de permissões (privilégios). Marque **TODOS OS PRIVILÉGIOS** (All Privileges) e clique em **Próxima Etapa**.

Resultado esperado: uma mensagem confirmando que o usuário foi adicionado ao banco.

Se você usou a ferramenta completa em vez do assistente e pulou isso, volte em **MySQL Databases**, procure a área "Adicionar Usuário ao Banco de Dados", escolha os dois na lista e marque todos os privilégios.

## Por que o host é localhost e não o endereço do seu site

O instalador pede "host do banco de dados" ou "servidor MySQL". A resposta, em hospedagem compartilhada, é quase sempre uma palavra:

`localhost`

Não é o endereço do seu site. Não é `www.seudominio.com.br`. Não é um número de IP (o número que identifica uma máquina na internet, como 192.0.2.10).

A analogia: os arquivos do seu site e o banco de dados moram no mesmo prédio. Para um morador do terceiro andar entregar um bilhete ao morador do quarto, ele não precisa do endereço da rua, do CEP nem dos Correios. Ele sobe um lance de escada. `localhost` significa exatamente isso: "o banco está aqui dentro, na mesma máquina".

Se a sua hospedagem usar um servidor de banco separado, ela informa o endereço correto na documentação ou no painel. Na dúvida, tente `localhost` primeiro: é o caso mais comum.

## A tabela que traduz cada campo do instalador

Com as anotações na mão, o preenchimento fica mecânico. A coluna do meio é um **exemplo fictício**, só para você ver o formato. Use sempre os valores que apareceram no seu painel.

| Campo do instalador | Exemplo (fictício) | De onde vem |
|---|---|---||
| Nome do banco de dados | `napoleo1_loja` | Tela de confirmação da etapa 2, com prefixo |
| Usuário do banco | `napoleo1_admin` | Tela de criação do usuário, com prefixo |
| Senha | a gerada pelo painel | Gerador de senhas, copiada antes de salvar |
| Host / servidor | `localhost` | Padrão da hospedagem compartilhada |
| Prefixo das tabelas | `wp_` | Campo extra de alguns instaladores, pode manter o padrão |

O último campo confunde porque tem nome parecido. **Prefixo de tabelas** é outra coisa: é um detalhe interno do sistema que você está instalando, não tem relação com o prefixo da conta de hospedagem. Pode deixar como veio.

## Os quatro erros que aparecem e o que fazer em cada um

| Mensagem que você vê | Causa mais provável | O que fazer |
|---|---|---||
| "Unknown database" / banco desconhecido | Você digitou o nome sem o prefixo da conta | Volte ao painel, copie o nome completo da lista de bancos |
| "Access denied for user" / acesso negado | Usuário criado mas não associado ao banco, ou senha errada | Refaça a associação com todos os privilégios; se persistir, troque a senha do usuário no painel |
| "Can't connect to MySQL server" | Host preenchido com o endereço do site | Troque por `localhost` |
| Senha "certa" que não entra | Símbolo especial na senha ou espaço colado junto | Gere uma senha só com letras e números e cole com cuidado |

Um detalhe que economiza tempo: quando você cola a senha, o navegador às vezes leva junto um espaço no fim. Esse espaço invisível é lido como parte da senha. Se tudo parece certo e nada funciona, apague o campo, digite a senha manualmente e tente de novo.

## As quatro linhas que você precisa guardar depois de instalar

Termine a instalação e salve as quatro linhas em um lugar seguro: gerenciador de senhas, ou um arquivo que você não perca. Você vai precisar delas em três momentos previsíveis.

- **Backup**: exportar o banco exige saber qual é o banco certo, e contas com vários sites têm vários bancos parecidos.
- **Mudança de hospedagem**: o novo servidor vai pedir os mesmos dados, e o prefixo da conta vai mudar.
- **Recuperação**: se o site sair do ar com erro de conexão, a primeira coisa a conferir é se essas quatro informações continuam batendo.

E uma orientação contra o nosso próprio interesse: se o seu site já funcionava e começou a dar erro de conexão com o banco sem que você tenha mexido em nada, não é hora de trocar de plano. Confira primeiro se a senha do usuário foi alterada, se o usuário continua associado ao banco e se o host ainda é `localhost`. Na maioria das vezes o conserto é um clique no painel, não um upgrade.

