Bancos de Dados

Crie bancos de dados PostgreSQL, MongoDB e Redis em segundos, com credenciais automáticas e acesso via localhost.

Bancos Disponíveis

Banco	Tipo	Uso Comum
PostgreSQL	Relacional	APIs, apps web, dados estruturados
MongoDB	Documento (NoSQL)	Apps flexíveis, dados semi-estruturados
Redis	Cache/Key-Value	Cache, filas, sessões, real-time

Criando um Banco de Dados

1. Acesse sua stack e clique em New App
2. Selecione Database como tipo
3. Escolha o banco desejado (PostgreSQL, MongoDB ou Redis)
4. Defina um nome
5. Clique em Create

O PodCubo cria o banco automaticamente com:

• Credenciais geradas (usuário e senha)
• Volume persistente pro armazenamento dos dados
• Acesso via localhost dentro da stack

Conectando sua App ao Banco de Dados

Uma stack no PodCubo é um pod — todos os containers compartilham a mesma rede local. Isso significa que sua app e seu banco de dados se comunicam via localhost, exatamente como no seu ambiente de desenvolvimento.

Pra conectar sua app ao banco, use uma variável de ambiente com a connection string. Vá na edição da sua app, na seção Environment Variables, e adicione a connection string do banco.

PostgreSQL

DATABASE_URL=postgresql://usuario:senha@localhost:5432/defaultdb

Pra aplicações Java/JDBC:

DATABASE_URL=jdbc:postgresql://localhost:5432/defaultdb?user=usuario&password=senha

MongoDB

DATABASE_URL=mongodb://usuario:senha@localhost:27017/defaultdb?authSource=admin

Redis

REDIS_URL=redis://default:senha@localhost:6379

Depois de adicionar, clique em Save & Restart pra aplicar.

Dica: As credenciais (usuário e senha) ficam disponíveis na seção Connection do app de banco de dados. Basta copiar a connection string de lá.

Lendo a variável na sua aplicação

// Node.js
const dbUrl = process.env.DATABASE_URL;

# Python
import os
db_url = os.environ["DATABASE_URL"]

// Go
dbUrl := os.Getenv("DATABASE_URL")

Por que localhost?

Todos os containers de uma stack rodam dentro do mesmo pod e compartilham a mesma interface de rede. Cada serviço escuta na sua porta padrão:

Serviço	Porta
PostgreSQL	localhost:5432
MongoDB	localhost:27017
Redis	localhost:6379
Sua app	localhost:3000 (ou a porta que você configurou)

Isso é seguro (ninguém de fora acessa), rápido (zero latência de rede) e simples (funciona igual ao seu ambiente local).

Conectando Remotamente

Se você precisa acessar o banco de dados por ferramentas externas como DBeaver, pgAdmin ou MongoDB Compass, o PodCubo disponibiliza acesso via domínio externo com TLS.

A connection string pra acesso remoto é diferente da local — usa o domínio público do banco ao invés de localhost.

PostgreSQL (remoto)

O PodCubo suporta conexão PostgreSQL via STARTTLS. Configure seu client com:

• Host: o domínio do app (ex: meu-postgres-xxxx.podcubo.com)
• Porta: 5432
• SSL: Required
• Usuário e senha: os mesmos da seção Connection

Connection string remota:

postgresql://usuario:senha@meu-postgres-xxxx.podcubo.com:5432/defaultdb?sslmode=require

MongoDB (remoto)

mongodb://usuario:senha@meu-mongo-xxxx.podcubo.com:27017/defaultdb?authSource=admin&tls=true

Redis (remoto)

rediss://default:senha@meu-redis-xxxx.podcubo.com:6379

Importante: Pra acesso remoto, use sempre a connection string com o domínio externo e TLS. A connection string com localhost funciona apenas dentro da stack.

Backups

Recomendamos configurar backups automáticos pra seus bancos de dados. O PodCubo oferece backup via rclone pra qualquer storage S3-compatible.