kbdemiranda/postgres repository overview

⁠PostgreSQL pt-BR

Imagem Docker do PostgreSQL⁠ oficial, pré-configurada para uso no Brasil: locale pt_BR.UTF-8, timezone padrão America/Sao_Paulo (GMT-3) e suporte multiarch (linux/amd64 e linux/arm64 — Intel/AMD, Apple Silicon, Snapdragon X Elite e outros).

⁠Tag disponível

⁠Uso rápido

Linux, macOS

docker run -d \
  --name PostgreSQL --hostname postgres \
  -e POSTGRES_USER=postgres -e POSTGRES_PASSWORD=postgres \
  -v hostPath:/var/lib/postgresql/data \
  -v hostPath:/docker-entrypoint-initdb.d \
  --restart always \
  -p 5432:5432 \
  kbdemiranda/postgres:17

Windows (Terminal / PowerShell)

docker run -d --name PostgreSQL --hostname postgres -e POSTGRES_USER=postgres -e POSTGRES_PASSWORD=postgres -v hostPath:/var/lib/postgresql/data -v hostPath:/docker-entrypoint-initdb.d --restart always -p 5432:5432 kbdemiranda/postgres:17

⁠Variáveis de ambiente

⁠POSTGRES_USER

Usuário administrador criado na primeira inicialização do container. É com ele que você cria os demais usuários, databases e tabelas.

⁠POSTGRES_PASSWORD

Senha do POSTGRES_USER. Obrigatória — o container não sobe sem ela.

⁠POSTGRES_DB

Opcional. Nome de um database criado automaticamente na primeira inicialização, além do database padrão postgres.

Para a lista completa de variáveis suportadas (réplicas, PGDATA customizado, etc.), consulte a documentação da imagem oficial⁠.

⁠Volumes

Ambos são opcionais, mas fortemente recomendados fora de ambientes descartáveis.

⁠/var/lib/postgresql/data

Onde ficam os arquivos de dados e configuração do cluster. Sem esse volume, destruir o container apaga o banco inteiro.

⁠/docker-entrypoint-initdb.d

Scripts (.sql ou .sh) colocados aqui são executados automaticamente, em ordem alfabética, apenas na primeira inicialização do container — ou seja, só quando o volume de dados está vazio.

⁠Locale e timezone

• Locale do sistema e collation padrão dos databases: pt_BR.UTF-8.
• Timezone padrão do servidor: America/Sao_Paulo, aplicado via -c timezone=America/Sao_Paulo.

Para usar outro timezone sem trocar de imagem, sobrescreva o comando do container:

docker run -d ... kbdemiranda/postgres:17 postgres -c timezone=UTC

⁠Origem

O Dockerfile desta imagem está neste repositório. Parte da imagem oficial postgres:17-bookworm, adicionando apenas locale e timezone.