Bom dia, meus amantes de banco de dados! (sei que isso não existe, mas vamos lá — estou tentando quebrar o gelo aqui 🫠)

Quero compartilhar um script para rodar o PostgreSQL usando docker-compose, que pode ser útil pra quem quer algo bem simples: só colocar pra rodar, com uma dashboard bonitinha pra visualizar os dados e fazer algumas queries também.

Sem muita enrolação, bora pro código:

version: '3'

services:
  database_postgres:    
    image: postgres:latest
    ports:
      - 5432:5432
    environment:
      POSTGRES_PASSWORD: password
      POSTGRES_USER: username
      POSTGRES_DB: database_name 
    volumes:
      - ${HOME}/postgres-data/:/var/lib/postgresql/data    

  pgweb:
    container_name: pgweb
    restart: always
    image: sosedoff/pgweb
    ports:
      - 8081:8081
    links:
      - database_postgres:database_postgres
    environment:
      - PGWEB_DATABASE_URL=postgres://username:password@database_postgres:5432/database_name?sslmode=disable
    depends_on:
      - database_postgres

🛠 Explicando um pouco mais

database_postgres

Nada muito novo sob o sol. São só algumas variáveis pra inicializar o banco com o usuário corretamente.

Mas o pulo do gato está em volumes:

Ali eu garanto que uma pasta será criada na HOME do usuário, e nela ficarão os dados do banco.

👉 Assim, se por acaso você der um docker-compose down (ou docker compose down, dependendo da versão), seus dados não serão perdidos.

Não é o ideal pra colocar em produção, mas quebra um galho e tanto em muitos casos! 😂

pgweb (Dashboard)

Tem duas coisas legais aqui:

• A URL de conexão é passada via variável de ambiente, facilitando tudo.
• O links cria uma ligação entre os serviços — define um alias, permitindo que o container pgweb acesse o banco de dados database_postgres pelo nome database_postgres.

Além disso, o depends_on garante que o banco suba antes da dashboard, evitando erros de conexão.

🚀 Rodando tudo

Depois de rodar um belo:

docker-compose up

Você já pode acessar sua dashboard no navegador pela URL:

http://localhost:8081/

Lá você pode executar queries ou só visualizar os dados — tudo direto do navegador, sem instalar mais nada.

✌️ É isso!

Espero que esse script seja útil pra alguém.

Qualquer dúvida, os comentários estão aí pra isso 🤙