# Criar banco de dados MySQL no cPanel em 4 passos

Guia por clique, sem terminal, para quem vai instalar WordPress, Moodle ou outro sistema à mão e travou na tela que pede nome do banco, usuário e senha.

> em 4 passos no assistente do cPanel: criar o banco, criar o usuário, marcar ALL PRIVILEGES e anotar os dados. O detalhe que derruba a instalação é o prefixo da conta, que o painel acrescenta ao nome escolhido (exemplo: loja vira conta_loja).

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

---

## O que é um banco de dados e por que seu site precisa de um

Seu site tem duas partes que vivem em lugares diferentes.

A primeira parte são os arquivos: as imagens, os arquivos do WordPress, o logotipo. Ficam guardados como pastas e arquivos, igual aos documentos do seu computador.

A segunda parte são os textos que mudam: o título de cada post, os comentários, os pedidos da loja, a lista de usuários. Isso não fica em arquivo solto. Fica num **banco de dados**, que funciona como um arquivo de fichas de um consultório: gavetas organizadas, cada ficha num lugar previsível, e um atendente que sabe buscar a ficha certa em um instante.

O atendente desse arquivo se chama **MySQL** (ou MariaDB, que é um parente próximo e se usa do mesmo jeito). Ele é o programa que guarda e devolve as fichas quando o site pede.

Para o site conversar com esse arquivo de fichas, ele precisa de três coisas: saber **qual** arquivo é o dele, ter um **crachá** (o usuário) e a **senha** do crachá. Criar essas três coisas é exatamente o que você vai fazer no **cPanel**, que é o painel de controle da hospedagem: a tela que você abre no navegador para administrar seu site, com botões e menus, sem digitar nenhum comando. Se a sua hospedagem tem cPanel, você recebeu por e-mail um endereço de acesso, um usuário e uma senha para entrar nele.

## Quando você precisa criar o banco à mão e quando não precisa

Se você instalou o WordPress pelo instalador automático da hospedagem, o banco já foi criado para você nos bastidores. Não precisa fazer nada. Pode fechar esta página e seguir a vida.

Você precisa criar o banco à mão quando:

- vai instalar o WordPress baixando o arquivo do site oficial e subindo você mesmo;
- vai instalar um sistema pronto que pede banco na tela de instalação: Moodle (plataforma de cursos online), um sistema de gestão de empresa, um sistema de chamados, ou um programa que um desenvolvedor entregou pronto para você;
- um desenvolvedor pediu "me manda os dados do banco";
- vai restaurar um site antigo num servidor novo.

Em todos esses casos aparece uma tela pedindo quatro campos. São sempre os mesmos quatro.

## Os quatro dados que todo instalador vai pedir

| Campo (nomes que aparecem) | O que é | De onde vem |
|---|---|---||
| Nome do banco / Database Name | O arquivo de fichas | Você cria no cPanel, e o painel acrescenta um prefixo |
| Usuário / Database User | O crachá que abre o arquivo | Você cria no cPanel, e o painel acrescenta o mesmo prefixo |
| Senha / Password | A senha do crachá | Você define no cPanel e anota na hora |
| Servidor / Host / Database Host | Onde o arquivo fica | Em hospedagem compartilhada, o site e o banco costumam estar na mesma máquina, e o valor aceito é `localhost`. Se o instalador recusar, pergunte ao seu provedor qual endereço usar |

Anote os quatro num bloco de notas antes de começar a instalação. A senha, principalmente: o cPanel não mostra a senha de novo depois que você fecha a tela.

## O prefixo da conta muda o nome que você digitou

Este é o ponto que derruba quase toda primeira instalação manual.

Numa hospedagem compartilhada, vários sites dividem o mesmo servidor MySQL. Se cada pessoa pudesse chamar seu banco de `loja`, o segundo a tentar não conseguiria. Para evitar essa colisão, o cPanel acrescenta na frente do nome o nome da sua conta de hospedagem, seguido de um underline. É o **prefixo**.

Exemplo fictício, só para você ver o formato. Suponha que sua conta de hospedagem se chame `napo1234`:

```
você digita:      loja
fica sendo:       napo1234_loja

você digita:      admin
o usuário fica:   napo1234_admin
```

O prefixo aparece escrito, em cinza, logo antes da caixinha onde você digita. Ele não é uma sugestão: é parte do nome. Segundo a [documentação oficial do cPanel para o Database Wizard](https://docs.cpanel.net/cpanel/databases/database-wizard/120/), o sistema adiciona esse prefixo ao nome do banco e ao nome do usuário.

No instalador do seu sistema, você tem que colar o nome **completo**, com prefixo. Colar só `loja` gera o erro clássico de "banco desconhecido". Colar só `admin` como usuário gera erro de acesso negado.

O nome da sua conta costuma ser o mesmo nome de usuário com que você entra no cPanel. Se tiver dúvida, o painel mostra o nome completo na tela de listagem dos bancos, e a gente chega nela mais adiante.

## Onde fica o Assistente de Banco de Dados MySQL no cPanel

Antes de começar, tenha em mãos: o endereço de acesso ao cPanel, seu usuário e sua senha do painel, e um bloco de notas aberto.

Dentro do cPanel, procure a seção **Databases** (Bancos de Dados) e clique em **MySQL Database Wizard** (Assistente de Banco de Dados MySQL). O assistente existe justamente para fazer as três criações em sequência, sem você esquecer nenhuma.

### Nomear o banco usando só minúsculas, números e sem acento

Digite um nome curto, só com letras minúsculas e números, sem espaço e sem acento. Algo que lembre o projeto: `loja`, `blog`, `site2` (exemplos).

Repare no prefixo cinza antes da caixa. Clique em **Next Step**.

Resultado esperado: uma mensagem confirmando que o banco foi adicionado, já mostrando o nome completo com prefixo. Copie esse nome inteiro para o bloco de notas.

### Criar o usuário e gerar a senha no próprio painel

Agora o assistente pede um nome de usuário. Mesmo esquema: você digita a parte final, o painel coloca o prefixo na frente.

Para a senha, use o botão **Password Generator** do próprio cPanel. Ele gera uma senha longa e aleatória, e mostra um medidor de força. Copie a senha gerada para o bloco de notas antes de confirmar. Essa senha não é a senha do seu cPanel e não é a senha de login do seu site: ela só serve para o site conversar com o banco, e você nunca mais vai digitá-la à mão depois da instalação.

Clique em **Create User**.

Resultado esperado: confirmação de que o usuário foi criado, com o nome completo visível.

### Marcar ALL PRIVILEGES para ligar o usuário ao banco

Esta é a etapa que as pessoas pulam quando criam banco e usuário separadamente, fora do assistente.

Criar o banco e criar o usuário não liga um no outro. É como emitir o crachá e nunca liberar a porta. Na tela de privilégios, marque **ALL PRIVILEGES** (todos os privilégios), que é a caixa no topo da lista e seleciona todas as outras de uma vez. Um sistema como WordPress ou Moodle precisa criar tabelas, alterar tabelas e apagar registros durante a instalação e durante as atualizações, então a permissão completa nesse banco específico é o que a instalação espera.

Clique em **Next Step**.

Resultado esperado: a tela final do assistente, confirmando que o usuário foi adicionado ao banco.

### Anotar os quatro valores antes de fechar o assistente

O assistente termina oferecendo voltar à lista de bancos. Antes disso, confira seu bloco de notas. Ele deve ter algo com esta cara (valores fictícios):

```
Nome do banco:  napo1234_loja
Usuário:        napo1234_admin
Senha:          (a senha gerada, copiada inteira)
Servidor:       localhost
```

Esses quatro valores são o que você vai colar no instalador do seu sistema.

## Como reler o nome completo do banco se você fechou a tela

Se você fechou a tela e não sabe mais o nome completo, ele continua guardado no painel. Nada se perdeu, exceto a senha.

No cPanel, na seção Databases, entre em **MySQL Databases** (Bancos de Dados MySQL). Essa tela lista, numa tabela:

- todos os bancos da conta, com o nome completo já com prefixo;
- quais usuários estão ligados a cada banco;
- todos os usuários criados.

É dessa tabela que você copia o nome exato para colar no instalador. Copie com o mouse, não digite de memória: um underline trocado por hífen já quebra a conexão.

A senha é o único item que não dá para reler. Se você esqueceu, não precisa recriar nada: na mesma tela de MySQL Databases, na lista de usuários, existe a opção de **alterar a senha** daquele usuário. Defina uma nova, anote, e use a nova no instalador. Se o site já estava funcionando com a senha antiga, trocar a senha do usuário do banco derruba o site até você atualizar o arquivo de configuração, então só troque se o site ainda não foi instalado ou se você sabe onde atualizar.

## Os erros mais comuns e o que cada um significa

| O que aparece na tela | Causa provável | O que fazer |
|---|---|---||
| Mensagem de banco desconhecido ("Unknown database") | Você colou o nome sem o prefixo | Volte em MySQL Databases e copie o nome completo |
| Acesso negado para o usuário ("Access denied for user") | Nome de usuário sem prefixo, senha errada, ou o usuário não foi adicionado ao banco | Confira usuário e senha; depois confira se o usuário aparece ligado ao banco na lista |
| "Erro ao estabelecer conexão com o banco de dados" no WordPress | Qualquer um dos quatro campos errado | Refaça os quatro, um por um, copiando e colando |
| O instalador reclama do servidor/host | `localhost` não é o valor aceito nessa hospedagem | Pergunte ao provedor qual endereço do servidor de banco usar |
| A instalação começa e trava ao criar tabelas | O usuário existe, mas sem privilégios suficientes | Em MySQL Databases, abra os privilégios daquele usuário no banco e marque ALL PRIVILEGES |
| O painel recusa o nome escolhido | Caracteres não aceitos, ou já existe um banco com esse nome | Use só minúsculas, números e underline, e escolha outro nome |

Um aviso que vale mais que qualquer atalho: se o site já existe e parou de funcionar, não crie um banco novo achando que resolve. Banco novo é banco vazio, e o conteúdo antigo continua no banco antigo. Nesse caso o problema é senha, privilégio ou arquivo de configuração, não falta de banco.

## Um banco por site, senha gerada e nunca a mesma senha do cPanel

Três hábitos que custam um minuto e evitam dor de cabeça.

**Um banco por site.** Se você hospeda três projetos na mesma conta, crie três bancos e três usuários. Assim, se um sistema for comprometido, o crachá dele não abre as fichas dos outros dois.

**Senha gerada, não inventada.** A senha do banco fica escrita dentro de um arquivo de configuração do site e ninguém a digita no dia a dia. Não há motivo para ela ser curta ou fácil. Use o gerador do cPanel.

**Nada de reaproveitar a senha do cPanel.** São coisas diferentes e devem ter senhas diferentes. Quem pegar uma não deve ganhar a outra de brinde.

Sobre backup: criar o banco não cria cópia de segurança dele. O cPanel tem uma área de Backup onde é possível baixar uma cópia do banco. Depois que seu site estiver com conteúdo, vale entender como funciona a rotina de cópias da sua hospedagem.

## Colar os quatro valores no instalador do seu sistema

Com os quatro valores anotados, volte para o instalador do sistema que você estava instalando e cole cada um no campo correspondente. No WordPress instalado à mão, essa é a tela que aparece logo depois de subir os arquivos e abrir o endereço do site no navegador. Em outros sistemas, o nome dos campos muda um pouco, mas continuam sendo os mesmos quatro.

Se o instalador aceitar e passar para a tela seguinte, a ligação está feita e você não precisa mexer mais nisso. O banco vai continuar ali, recebendo cada texto novo que você publicar, sem pedir sua atenção.

Um último esclarecimento de honestidade: este guia não traz medição de desempenho nossa. Ele descreve o caminho de clique do painel e se apoia na [documentação oficial do cPanel sobre o Database Wizard](https://docs.cpanel.net/cpanel/databases/database-wizard/120/). Todo nome de conta, de banco e de usuário citado aqui é exemplo fictício: o seu virá com o prefixo da sua própria conta.

