Banco de dados no Coolify: PostgreSQL passo a passo

Resposta rápida

Para criar um banco de dados no Coolify, abra o ambiente do projeto, clique em New Resource e escolha o banco no grupo Databases, como o PostgreSQL. Escolha a imagem (o PostgreSQL 18 é a padrão), dê um nome e clique em Start. O painel gera usuário e senha. A aplicação se conecta pela URL interna, que você copia para uma variável como DATABASE_URL. O acesso de fora da VPS vem fechado (Private) e deve continuar assim, salvo necessidade.

O painel do Coolify é em inglês. Neste manual, os botões aparecem como estão na tela, em negrito, com a tradução ao lado. Dúvida com algum termo? Veja o glossário do Coolify em português.

Você vai aprender

Criar um banco PostgreSQL pelo painel e ligá-lo
Encontrar o usuário, a senha e o nome do banco
Ligar a aplicação ao banco pela URL interna, sem expor o banco na internet
Saber quando abrir o acesso público e como restringir

Antes de começar

O Coolify instalado na sua VPS e um projeto criado (projetos e ambientes)
Para ligar uma aplicação: a aplicação já publicada no mesmo servidor (publicar pelo Git)

Neste guia

Como o banco funciona no Coolify
Crie o banco
Confira as credenciais
Ligue a aplicação ao banco
Acesso de fora da VPS, só se precisar
Onde ficam os dados
Problemas comuns

Como o banco funciona no Coolify

Aplicaçãolê o endereço do banco numa variável, como DATABASE_URL
Rede Dockeraplicação e banco na mesma rede interna, sem passar pela internet
Contêiner do bancoo PostgreSQL, MySQL ou outro, com usuário e senha gerados pelo painel
Volume no NVMeos dados ficam gravados no disco da VPS

A aplicação fala com o banco por dentro da VPS

Cada banco é um recurso do projeto, num contêiner próprio. O Coolify sobe pelo painel PostgreSQL, MySQL, MariaDB, MongoDB, ClickHouse, Redis (Valkey), KeyDB e Dragonfly. Os três últimos guardam dados em memória e servem para cache, filas e sessões.

Crie o banco

Escolha o PostgreSQL no grupo Databases
No painel: ProjectsLoja VirtualproductionNew Resource(Projetos › o seu projeto › o ambiente › novo recurso)
No ambiente do projeto, clique em New Resource (novo recurso). No grupo Databases (bancos de dados), clique em Configure (configurar) ao lado de PostgreSQL.
Escolha a imagem PostgreSQL 18
Clique em PostgreSQL 18, a imagem marcada como Default (padrão). As outras servem para versões anteriores ou para extensões, como PostGIS e PGVector.
Dê um nome e clique em Start
O banco nasce parado, com o status Exited (parado). Troque o nome automático, salve com Save changes e clique em Start (iniciar).
1. Nome do banco (Name), aqui banco-da-loja.
2. Botão Start, que liga o banco. O status muda para Running (rodando).

Confira as credenciais

Veja usuário, senha e banco
Na página do banco, a seção Credentials (credenciais) mostra os dados de acesso. A senha vem escondida: o olho mostra e o outro botão copia.
1. Username: O usuário do banco (aqui, postgres).
2. Password: A senha que o painel gerou. Não precisa anotar: ela já entra na URL interna.
3. Initial database: O banco criado na primeira inicialização (aqui, postgres).

A senha muda no banco primeiro

O painel avisa: Keep credentials synchronized (mantenha as credenciais sincronizadas). Trocar a senha no formulário não muda a senha dentro do PostgreSQL. Mude primeiro no banco, depois atualize o campo Password, para o backup e a URL interna continuarem funcionando, e por fim a variável da aplicação.

psql -U postgres -c "ALTER USER postgres WITH PASSWORD 'SENHA-NOVA'"

Troca da senha dentro do PostgreSQL, no Terminal do banco. A aplicação perde a conexão até receber a senha nova.

Ligue a aplicação ao banco

Copie a URL interna
Na seção Connection (conexão), copie o valor de Postgres URL (internal). Ele já traz usuário, senha, nome do contêiner, porta e banco.
1. URL interna (Postgres URL (internal)), escondida. O ícone de cópia copia o valor completo.
2. Acesso público (Access): Private (privado), o padrão. O banco não fica exposto na internet.
Cole na variável da aplicação
Na aplicação, crie a variável DATABASE_URL com o valor copiado e faça Redeploy. Veja como em variáveis de ambiente.

DATABASE_URL=postgres://USUARIO:SENHA@NOME-DO-CONTEINER:5432/postgres

Formato da URL interna. Cole o valor que o painel mostra, sem montar à mão.

A URL interna usa o nome do contêiner, não o IP da VPS. Ela só funciona para recursos na mesma rede Docker, como uma aplicação no mesmo servidor. É o caminho mais seguro: o banco conversa com a aplicação sem porta aberta para fora.

Acesso de fora da VPS, só se precisar

Para usar um programa de banco no seu computador, troque Access para Public through TCP proxy (público por proxy TCP) e defina a Public port (porta pública). Quando terminar, volte para Private.

Não deixe o banco aberto para a internet

Banco público recebe tentativas de acesso o tempo todo. Libere a porta no firewall só para o IP de quem precisa e use senha forte. Lembre que o UFW sozinho não bloqueia uma porta publicada pelo Docker: veja segurança do Coolify. A criptografia (SSL configuration) só muda com o banco parado.

Onde ficam os dados

Os dados ficam num volume do Docker, no disco NVMe da própria VPS. Volume não é backup: se o banco for apagado ou corrompido, o volume vai junto. Agende o backup do banco de dados e guarde uma cópia fora da VPS.

Como saber se deu certo

O banco aparece como Running no alto da página, a aplicação lê a URL interna pela variável DATABASE_URL e o acesso público continua Private.

Problemas comuns

A aplicação não conecta ao banco

Causa provável: O banco está parado (Exited), a URL foi digitada à mão com erro ou a aplicação está em outro servidor, fora da rede Docker do banco.
O que fazer: Clique em Start se o banco estiver parado. Copie de novo a Postgres URL (internal) para a variável e faça Redeploy. Aplicação e banco precisam estar no mesmo servidor.

Depois de trocar a senha, a aplicação e o backup pararam

Causa provável: A senha mudou só no formulário do painel ou só no banco.
O que fazer: Deixe a mesma senha no banco e no campo Password. Depois atualize DATABASE_URL na aplicação e faça Redeploy.

O programa de banco no meu computador não conecta

Causa provável: O acesso está Private ou a porta pública está fechada no firewall da VPS.
O que fazer: Troque Access para Public through TCP proxy, confira a Public port e libere essa porta no firewall só para o seu IP.

Não resolveu? Veja os problemas comuns do Coolify ou abra um chamado na central do cliente.

Próximo passoComo fazer backup do banco de dados no CoolifyBackup agendado do banco pelo painel: frequência em cron, retenção, cópia em armazenamento compatível com S3 e a restauração.

Fontes e documentação oficial

Coolify é um software de código aberto mantido pelo próprio projeto. Este manual é da Hospedagem Segura, para quem roda o Coolify nas nossas VPS, e foi conferido na versão 4.7.5.

Continue aprendendo

Ver todos os guias do Manual do Coolify

Rode o Coolify numa VPS da Hospedagem Segura

VPS Linux com acesso root, disco NVMe e IPv4 dedicado a partir de R$ 69,90/mês. Prefere a VPS pronta? No VPS Assistido, o Coolify vem instalado, com o painel no seu domínio, e a equipe ajuda no dia a dia.

Ver VPS para Coolify Conhecer o VPS Assistido