# Conectar um banco externo

> Registre um banco que já existe fora da W8 Hub — PostgreSQL, MySQL, Redis ou MongoDB — e gerencie contas de acesso pelo mesmo painel.

_Fonte: https://w8hub.com.br/docs/bancos-externos_

Nem todo banco precisa ser provisionado aqui. Se você já tem um PostgreSQL na AWS, um MySQL no servidor antigo ou um MongoDB Atlas, dá para **registrar esse banco na W8 Hub** e administrar as contas de acesso pelo mesmo painel, sem migrar dado nenhum.

É o caminho para quem está migrando aos poucos, para quem tem um banco que precisa ficar onde está por contrato, e para quem quer um lugar só para gerenciar quem acessa o quê.

> [!TIP]
> Banco externo **não consome recursos do seu plano** — ele roda onde sempre rodou. O que a W8 Hub faz é guardar a conexão com segurança e administrar as contas. Se você quer um banco gerenciado, com backup e métricas, veja [Bancos de dados](https://w8hub.com.br/docs/bancos-de-dados).

## Engines aceitos

**PostgreSQL**, **MySQL**, **Redis** e **MongoDB**.

## Registrar o banco

O painel pede os dados de conexão:

| Campo | O que é |
|---|---|
| **Rótulo** | O nome que aparece na lista. Use algo que identifique o ambiente: `Postgres produção`, `Redis legado`. |
| **Engine** | PostgreSQL, MySQL, Redis ou MongoDB. |
| **Host** e **porta** | Onde o banco responde. |
| **Database** | O nome do banco a que você vai se conectar. |
| **Usuário** e **senha** | Uma conta com permissão para administrar as demais. |

Há também campos opcionais, que você só preenche quando o seu banco exige:

- **Certificado (CA)** — se o banco só aceita TLS com uma autoridade certificadora própria, cole o certificado aqui.
- **Somente leitura** — marca o registro inteiro como de leitura, útil para uma réplica.
- **authSource** e **authMechanism** — específicos do MongoDB, quando a autenticação não fica no database padrão.

> [!WARNING]
> O banco precisa **aceitar conexão** da W8 Hub. Se ele estiver atrás de firewall ou em rede privada, libere o acesso antes — senão o teste falha e o registro não é criado.

## Testar antes de salvar

Existe um **teste de conexão** que usa exatamente os dados do formulário e não grava nada. Use sempre: é mais rápido descobrir ali que a porta está fechada do que depois, com a aplicação no ar.

## Contas de acesso

Registrado o banco, você administra as contas dele pelo painel, como faz com um banco gerenciado:

- **Criar conta** — usuário e senha, com a opção de já nascer somente leitura.
- **Somente leitura** — liga e desliga a qualquer momento, sem recriar a conta. É o jeito de dar acesso a relatório sem risco de escrita.
- **Redefinir senha** — gera uma senha nova para a conta.
- **Remover conta** — apaga o usuário no banco.

> [!WARNING]
> Estas ações acontecem **no seu banco**, não numa cópia. Remover uma conta aqui remove o usuário lá.

## Próximo passo

Com as contas criadas, aponte a aplicação para elas usando as [variáveis de ambiente](https://w8hub.com.br/docs/instalacao-configuracoes#variaveis-de-ambiente) da instalação.