{"id":642,"date":"2026-08-03T17:27:57","date_gmt":"2026-08-03T20:27:57","guid":{"rendered":"https:\/\/www.wllsistemas.com.br\/blog\/?p=642"},"modified":"2026-08-04T06:57:39","modified_gmt":"2026-08-04T09:57:39","slug":"erro-na-instalacao-do-postgresql","status":"publish","type":"post","link":"https:\/\/www.wllsistemas.com.br\/blog\/erro-na-instalacao-do-postgresql","title":{"rendered":"Erro na instala\u00e7\u00e3o do PostgreSQL"},"content":{"rendered":"\n

Erro ao instalar o **PostgreSQL no Windows 9.2 ou 11.5**<\/strong> e, no meio do processo, apareceu a janela de aviso:
Problem running post-install step. Installation may not complete correctly The database cluster initialisation failed.<\/strong><\/p>\n\n\n\n

\"Problem<\/figure>\n\n\n\n


Esse \u00e9 um dos erros mais comuns (e mais mal documentados) do instalador oficial da EnterpriseDB para Windows. Neste post explico o motivo real por tr\u00e1s desse erro e a solu\u00e7\u00e3o que resolveu o problema em um caso pr\u00e1tico de instala\u00e7\u00e3o do *PostgreSQL*<\/strong>.<\/p>\n\n\n\n


O que significa esse erro<\/strong>
Durante a instala\u00e7\u00e3o, o instalador do PostgreSQL executa automaticamente o utilit\u00e1rio `initdb`, respons\u00e1vel por criar o **cluster de banco de dados**<\/strong> (a estrutura inicial de arquivos e diret\u00f3rios onde o PostgreSQL vai armazenar os dados). Quando esse passo falha, a instala\u00e7\u00e3o \u00e9 conclu\u00edda de forma incompleta: os bin\u00e1rios s\u00e3o copiados, mas o banco de dados n\u00e3o fica funcional.
O aviso gen\u00e9rico “Problem running post-install step” n\u00e3o informa a causa exata, o que leva muita gente a reinstalar o sistema operacional ou baixar outra vers\u00e3o do instalador sem necessidade.<\/p>\n\n\n\n


Causa mais comum: espa\u00e7o no nome ou acentua\u00e7\u00e3o do usu\u00e1rio ou do Windows<\/strong>
Na maioria dos casos relatados, o problema acontece quando o nome do usu\u00e1rio do Windows cont\u00e9m espa\u00e7o<\/strong> \u2014 por exemplo, um perfil chamado `BALCAO 1<\/strong>`, `PDV 01<\/strong>`, `CAIXA 2<\/strong>` ou similar, muito comum em computadores de lojas, restaurantes e sistemas de PDV (frente de caixa).<\/p>\n\n\n\n


O motivo t\u00e9cnico \u00e9 o seguinte: o processo de instala\u00e7\u00e3o do PostgreSQL utiliza as vari\u00e1veis de ambiente **`TEMP`**<\/strong> e **`TMP`**<\/strong> do usu\u00e1rio logado para gravar arquivos tempor\u00e1rios durante a cria\u00e7\u00e3o do cluster. Como o perfil do usu\u00e1rio fica em:
“`C:\\Users\\BALCAO 1\\AppData\\Local\\Temp“`<\/p>\n\n\n\n


O espa\u00e7o no nome da pasta quebra a chamada do `initdb`, que n\u00e3o interpreta corretamente o caminho. Resultado: o cluster n\u00e3o \u00e9 criado e a instala\u00e7\u00e3o trava com a mensagem de erro.<\/p>\n\n\n\n


Vale refor\u00e7ar que acentos tamb\u00e9m podem causar o mesmo problema.<\/strong><\/p>\n\n\n\n


Como resolver: apontando TEMP e TMP para uma pasta sem espa\u00e7o<\/strong>
A solu\u00e7\u00e3o mais confi\u00e1vel \u00e9 redirecionar as vari\u00e1veis de ambiente `TEMP` e `TMP` do Windows para um caminho simples, sem espa\u00e7os, antes de rodar o instalador<\/strong>, exemplo C:\\TEMP<\/strong>.<\/p>\n\n\n\n


Passo a passo<\/strong>
1. Abra o Painel de Controle<\/strong> \u2192 Sistema<\/strong> \u2192 Configura\u00e7\u00f5es avan\u00e7adas do sistema<\/strong>.<\/p>\n\n\n\n

2. Na aba Avan\u00e7ado<\/strong>, clique em Vari\u00e1veis de Ambiente<\/strong>.<\/p>\n\n\n\n

3. Na se\u00e7\u00e3o Vari\u00e1veis do sistema<\/strong> (a de baixo, n\u00e3o a do usu\u00e1rio), localize e edite:\u00a0 \u00a0– `TEMP` \u2192 `C:\\Temp`\u00a0 \u00a0– `TMP` \u2192 `C:\\Temp`<\/p>\n\n\n\n

4. Caso a pasta `C:\\Temp` n\u00e3o exista, crie-a antes.<\/p>\n\n\n\n

5. Clique em OK<\/strong> em todas as janelas para salvar.<\/p>\n\n\n\n

6. Reinicie o computador<\/strong> (seria o ideal, mas funciona sem reiniciar).<\/p>\n\n\n\n

7. Execute o instalador do PostgreSQL novamente, de prefer\u00eancia como Administrador<\/strong>.
Depois dessa altera\u00e7\u00e3o, o `initdb` passa a gravar seus arquivos tempor\u00e1rios em `C:\\Temp`, um caminho sem espa\u00e7os, e o cluster \u00e9 criado normalmente.<\/p>\n\n\n\n


Cuidados extras que ajudam a evitar o erro<\/strong>
Mesmo com o ajuste de `TEMP`\/`TMP`, algumas boas pr\u00e1ticas reduzem ainda mais o risco de falha na instala\u00e7\u00e3o:
– Evite instalar como usu\u00e1rio com nome contendo espa\u00e7o ou acento<\/strong> sempre que poss\u00edvel.<\/p>\n\n\n\n

– Desative temporariamente o antiv\u00edrus<\/strong> durante a instala\u00e7\u00e3o, j\u00e1 que alguns bloqueiam a execu\u00e7\u00e3o do `initdb.exe`.<\/p>\n\n\n\n

– Ao definir o Data Directory<\/strong> na instala\u00e7\u00e3o, prefira um caminho simples, como `C:\\PostgreSQL\\11\\data`, em vez do padr\u00e3o em “Program Files”.<\/p>\n\n\n\n

– Sempre execute o instalador com “Executar como administrador”<\/strong>.<\/p>\n\n\n\n

<\/p>\n\n\n\n


Esse tipo de problema \u00e9 bastante comum em m\u00e1quinas de PDV, caixas de loja e terminais de restaurante, onde os nomes de usu\u00e1rio costumam seguir padr\u00f5es como “Caixa 1”, “Balc\u00e3o 2” etc. Se voc\u00ea administra sistemas de automa\u00e7\u00e3o comercial, vale por padr\u00e3o evitar espa\u00e7os nos nomes de usu\u00e1rio do Windows para prevenir esse e outros problemas semelhantes em instaladores de terceiros.<\/p>\n","protected":false},"excerpt":{"rendered":"

Erro ao instalar o **PostgreSQL no Windows 9.2 ou 11.5** e, no meio do processo, apareceu a janela de aviso:Problem running post-install step. Installation may not complete correctly The database cluster initialisation failed. Esse \u00e9 um dos erros mais comuns (e mais mal documentados) do instalador oficial da EnterpriseDB para Windows. Neste post explico o Leia mais… »<\/a><\/p>\n","protected":false},"author":1,"featured_media":648,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":[],"categories":[5],"tags":[34,33,32],"_links":{"self":[{"href":"https:\/\/www.wllsistemas.com.br\/blog\/wp-json\/wp\/v2\/posts\/642"}],"collection":[{"href":"https:\/\/www.wllsistemas.com.br\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.wllsistemas.com.br\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.wllsistemas.com.br\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.wllsistemas.com.br\/blog\/wp-json\/wp\/v2\/comments?post=642"}],"version-history":[{"count":6,"href":"https:\/\/www.wllsistemas.com.br\/blog\/wp-json\/wp\/v2\/posts\/642\/revisions"}],"predecessor-version":[{"id":650,"href":"https:\/\/www.wllsistemas.com.br\/blog\/wp-json\/wp\/v2\/posts\/642\/revisions\/650"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.wllsistemas.com.br\/blog\/wp-json\/wp\/v2\/media\/648"}],"wp:attachment":[{"href":"https:\/\/www.wllsistemas.com.br\/blog\/wp-json\/wp\/v2\/media?parent=642"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.wllsistemas.com.br\/blog\/wp-json\/wp\/v2\/categories?post=642"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.wllsistemas.com.br\/blog\/wp-json\/wp\/v2\/tags?post=642"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}