Como instalar o PostgreSQL passo a passo

Antes de começar

Reúna estes itens para a instalação correr sem tropeço:

• Um computador com Windows, Linux (Ubuntu ou Debian) ou macOS.
• Permissão de administrador no sistema.
• Uma senha que você vai criar e guardar, para o superusuário do banco.
• Um nome de usuário e de máquina só com caracteres ASCII (sem acento), no Windows. A EDB recomenda isso para evitar erro de caminho.

No Windows, a EDB testa o instalador em versões de 64 bits. Para o PostgreSQL 18, são o Windows Server 2025 e 2022. As edições desktop comparáveis devem funcionar, mas não são testadas oficialmente. Para outras versões do PostgreSQL, a tabela completa está na página oficial para Windows.

Instalar no Windows

O postgresql.org indica o instalador certificado pela EDB (EnterpriseDB). Ele fica hospedado nos servidores da EDB, e não nos da comunidade PostgreSQL. O caminho é este:

1. Abra postgresql.org/download/windows e siga o link para o instalador da EDB.
2. Escolha a versão do PostgreSQL e baixe o arquivo para o seu sistema.
3. Execute o instalador como administrador (clique com o botão direito e escolha "Executar como administrador").
4. Aceite o diretório de instalação padrão ou escolha outro.
5. Na tela de componentes, mantenha o servidor PostgreSQL e as ferramentas de linha de comando (que trazem o psql). O pgAdmin 4 e o Stack Builder também aparecem na lista.
6. Aceite o diretório de dados padrão.
7. Na tela Password, defina a senha. Segundo a EDB, ela vale para o superusuário do banco e para a conta de serviço postgres.
8. Na tela Port, mantenha a porta 5432, a padrão indicada pela EDB, a menos que ela já esteja em uso.
9. Aceite o locale (idioma e formato regional) sugerido, que segue o do seu sistema.
10. Revise o resumo, clique em Next e aguarde. No fim, clique em Finish.

O pgAdmin é uma ferramenta gráfica para gerenciar o banco. Quando quiser usá-la, leia o guia do pgAdmin. O Stack Builder serve para baixar drivers e ferramentas extras depois.

Por padrão, o instalador não altera o PATH do sistema, a lista de pastas onde o Windows procura programas. Para chamar o psql de qualquer terminal, adicione a pasta bin do diretório de instalação à variável Path.

Instalar no Ubuntu e no Debian

Na documentação oficial, o PostgreSQL já vem disponível nos repositórios do Ubuntu e do Debian. A versão desse pacote fica fixa durante o ciclo de vida da versão do sistema. Para instalar essa versão, abra o terminal e rode:

apt install postgresql

Se você precisa de outra versão, use o repositório oficial do PostgreSQL (apt.postgresql.org). Ele traz atualizações automáticas das versões com suporte. A configuração automática, igual no Ubuntu e no Debian, é esta:

sudo apt install -y postgresql-common
sudo /usr/share/postgresql-common/pgdg/apt.postgresql.org.sh

Depois, instale a versão desejada, trocando 18 pelo número que você quer:

sudo apt update
sudo apt install postgresql-18

A configuração manual do repositório também existe. Ela está descrita nas páginas oficiais para Ubuntu e Debian. Confira ali quais versões do sistema o repositório atende.

Instalar no macOS

A página oficial para macOS lista estes caminhos:

• Instalador da EDB: inclui o servidor, o pgAdmin e o Stack Builder, e funciona em modo gráfico.
• Postgres.app: aplicativo nativo que fica na barra de menus. O servidor inicia ao abrir o app e fecha quando você o encerra.
• Homebrew: instalação por linha de comando, no formato brew install postgresql@15 (o número troca conforme a versão).
• MacPorts e Fink: pacotes mantidos por esses projetos.

A compatibilidade do instalador da EDB com a versão do macOS está em uma tabela na mesma página. Para o PostgreSQL 18, por exemplo, ela indica macOS 13 ou superior.

Como saber se deu certo

Para testar, abra um terminal e conecte com o psql, o terminal interativo do PostgreSQL. As opções -h (máquina), -p (porta) e -U (usuário) vêm da documentação do psql:

psql -h localhost -p 5432 -U postgres

O psql pede a senha que você definiu. Se a conexão funcionar, aparece um prompt, a linha onde você digita os comandos. Para ver a lista de comandos internos, digite \?. Para sair, digite \q.

O comando \conninfo mostra os dados da conexão atual, incluindo se o usuário é superusuário. Se esse retorno aparecer, o servidor está respondendo e a instalação cumpriu o papel.

Sem o nome do usuário, o psql usa o nome da sua conta do sistema operacional. Por isso, em instalações novas, informar o -U evita confusão.

Erros comuns na instalação

• "psql não é reconhecido" no Windows: o PATH não inclui a pasta bin. Adicione-a, como descrito acima.
• Porta em uso: outro programa ocupa a 5432. Escolha outra porta na tela Port e informe-a no -p ao conectar.
• Senha esquecida: anote a senha na hora da instalação. Sem ela, a conexão pelo -U postgres não funciona.
• Instalador de origem estranha: baixe só pelas páginas do postgresql.org. Arquivos de sites de terceiros podem trazer programas que você não pediu.
• Versão sem suporte: baixar uma versão antiga deixa o banco sem correções. Confira antes a tabela de versões.

Versões e data da conferência

Conferido em 28 de outubro de 2026 no postgresql.org: a versão estável mais recente era a 18, e a 14 tinha fim de suporte marcado para 12 de novembro de 2026. A página também citava um release candidate (candidato a lançamento) da versão 19, que ainda é pré-lançamento. Como as versões mudam, abra a página oficial antes de baixar.

Próximo passo

Com o servidor funcionando, o caminho natural é aprender a criar bancos e tabelas. Para uma interface gráfica além do pgAdmin, veja o guia do DBeaver. Para entender como o PostgreSQL se encaixa no mundo dos bancos de dados, a resposta curta do silo reúne os temas relacionados. Quando quiser o panorama geral do site, a resposta rápida é o ponto de partida.

Fonte: postgresql.org e documentação da EDB. Verificado em 28 de outubro de 2026.