# n8n self-hosted com Postgres

O que um n8n self-hosted estável pede: Postgres no lugar do SQLite, chave de criptografia fixa, URL pública de webhook e um backup já restaurado.

Canonical URL: https://unbroker.cloud/pt/blog/self-host-n8n
Published: 2026-11-01
Reviewed: 2026-11-01
Author: Timoteo Borgobello

## O que você precisa para hospedar o n8n

Para hospedar n8n e deixá-lo estável, você precisa de cinco coisas: o contêiner do n8n, Postgres no lugar do arquivo SQLite padrão, um volume persistente para a pasta de usuário do n8n, uma chave de criptografia que você define uma vez e guarda, e uma URL pública para os webhooks.

O n8n escuta na porta 5678. A instalação com Docker do n8n roda a imagem `n8nio/n8n` e publica essa porta. O template desta nota roda no Cloud Apps. Um [servidor Linux na nuvem](https://unbroker.cloud/pt/servidores-cloud) é a outra forma, quando você quer operar o host. Se esse host roda um PaaS auto-hospedado, o que continua com você está em [PaaS auto-hospedado](https://unbroker.cloud/pt/blog/self-hosted-paas). O [modelo n8n](https://unbroker.cloud/templates/n8n) na Unbroker roda `n8nio/n8n:2.44.1` na mesma porta, com um Postgres 16 privado, um volume de 1 GiB para os dados do n8n e um volume de 1 GiB para o Postgres. Esta nota é a configuração que mantém esse arranjo estável. Como conectar um app ao Postgres, e como restaurá-lo, está em [Postgres em produção](https://unbroker.cloud/pt/blog/postgres-in-production). Um stack de vários serviços, como o Supabase, é outro inventário: [Hospedar Supabase](https://unbroker.cloud/pt/blog/self-host-supabase).

## Por que Postgres em vez do SQLite

Por padrão, o n8n usa SQLite para gravar credenciais, execuções antigas e workflows. O arquivo é `~/.n8n/database.sqlite` quando você não configurou um banco. O n8n também suporta PostgreSQL. Você escolhe com `DB_TYPE=postgresdb` e depois define `DB_POSTGRESDB_HOST`, `DB_POSTGRESDB_PORT`, `DB_POSTGRESDB_DATABASE`, `DB_POSTGRESDB_USER` e `DB_POSTGRESDB_PASSWORD`. O nome do banco começa em `n8n`. O usuário começa em `postgres`. O host começa em `localhost` e a porta em `5432`.

A página de bancos do n8n lista o PostgreSQL 16 como a versão maior extra de compatibilidade, ao lado de 17 e 18, numa nota de julho de 2026. A mesma página diz que essa faixa muda todo novembro, então leia de novo antes de escolher outra maior. Queue mode com SQLite não é recomendado, e uma fila distribuída sobre SQLite não é suportada. O modelo não liga o queue mode. Ele define `DB_TYPE=postgresdb` e aponta as variáveis de Postgres para um serviço Postgres 16 privado. Workflows, execuções e usuários ficam nesse banco.

Esse banco é um nó de Apps que você opera: uma imagem, um volume e a recuperação desse volume. Não é um cluster de [Postgres gerenciado](https://unbroker.cloud/managed-databases/postgres). Postgres gerenciado na Unbroker exige Pro. O menor plano do catálogo é 1 vCPU, 1 GB de RAM e 10 GB de armazenamento a $21.21 por mês, separado da mensalidade Pro.

<aside class="plan-box">
<p><strong>Na Unbroker.</strong> O serviço de banco do modelo é um Postgres 16 privado com um volume de 1 GiB. Você cuida das atualizações do motor e da recuperação desse volume. Um cluster gerenciado é outro produto. A lista de planos está em <a href="/managed-databases/postgres">Postgres gerenciado</a>.</p>
</aside>

## A chave de criptografia

O n8n criptografa as credenciais antes de gravá-las. Se você não definir uma chave, o n8n gera uma aleatória na primeira inicialização e grava na pasta de usuário. `N8N_ENCRYPTION_KEY` é como você informa essa chave, antes de ela ser escrita no arquivo de configuração. Sem a chave, um banco restaurado ou uma exportação criptografada de credenciais não pode ser descriptografado.

O modelo gera `N8N_ENCRYPTION_KEY`. Não mude nem apague. Se você perder, as credenciais gravadas ficam ilegíveis. As notas de rotação do n8n dizem que esta chave da instância não muda: ela protege as chaves de dados. Faça um backup completo do banco antes de ligar essa rotação.

`N8N_USER_FOLDER` é o caminho onde o n8n cria a pasta `.n8n`. O modelo define `/data` e monta ali um volume de 1 GiB, para arquivos de credenciais e nós da comunidade. Com Postgres, o banco fica fora dessa pasta. A pasta ainda guarda a configuração do n8n, então entra no backup.

## URL de webhook e domínio próprio

O n8n monta a URL de um webhook com protocolo, host e porta. Atrás de um proxy reverso, essa combinação é o endereço interno, não o público. Defina a URL base de webhook para o editor mostrar a URL que você registrou nos outros serviços.

A documentação do n8n chama de `N8N_WEBHOOK_URL` essa URL base, para webhooks de teste e de produção. `WEBHOOK_URL` é um alias descontinuado desde o n8n 2.35.0. Ainda funciona, e o n8n registra um aviso de descontinuação na inicialização. A imagem do modelo é `n8nio/n8n:2.44.1`, e o modelo define `WEBHOOK_URL` com a URL pública do serviço.

`N8N_EDITOR_BASE_URL` é a URL pública do editor. O n8n também usa essa URL em e-mails e como redirect do SAML. O modelo define o mesmo endereço público e define `N8N_PROXY_HOPS` como `1`, que é a quantidade de saltos que a documentação do proxy reverso pede. Essa documentação também lista `X-Forwarded-For`, `X-Forwarded-Host` e `X-Forwarded-Proto` no último proxy quando você mesmo roda esse proxy.

Se você adicionar um domínio próprio, atualize `WEBHOOK_URL` e `N8N_EDITOR_BASE_URL` para as duas apontarem para esse domínio. O modelo não reescreve isso sozinho.

## Crie a conta owner na hora

Na primeira vez que você abre o n8n, o app mostra uma tela de cadastro. A conta criada ali é o owner da instância. A senha precisa ter pelo menos oito caracteres, com um número e uma letra maiúscula. O modelo avisa que a primeira pessoa que abre a URL fica com esse cadastro. Abra você mesmo assim que o serviço estiver no ar.

O n8n recomenda um servidor SMTP para convites e redefinição de senha, e diz que o SMTP é opcional desde o n8n 0.210.1. Se você pular, os usuários não conseguem redefinir a senha. O modelo não configura SMTP.

## Não deixe as execuções encherem o banco

Execuções concluídas, e os dados gravados com elas, são o que faz o banco crescer. O n8n apaga esse histórico de forma contínua, e a poda já vem ligada.

`EXECUTIONS_DATA_PRUNE` começa em `true`. Uma execução concluída entra quando passa de `EXECUTIONS_DATA_MAX_AGE` horas, ou quando a quantidade gravada passa de `EXECUTIONS_DATA_PRUNE_MAX_COUNT`. A idade padrão é 336 horas, ou seja, 14 dias. A quantidade padrão é 10.000. Defina a quantidade como `0` se não quiser limite por quantidade. Quando a poda é por quantidade, o n8n apaga da mais antiga para a mais nova. Execuções em `new`, `running` ou `waiting` não entram. Execuções anotadas, por exemplo com tags ou uma avaliação, nunca são podadas.

O modelo não define essas variáveis, então valem esses padrões. Mude `EXECUTIONS_DATA_MAX_AGE` se 14 dias não for a janela que você precisa. No SQLite padrão, as linhas podadas não devolvem disco até um vacuum. O modelo usa Postgres, então esse limite do SQLite não se aplica.

## Fuso horário, agendamentos e memória

O Schedule Trigger usa o fuso do workflow se esse workflow tiver um. Se não tiver, usa o fuso da instância. O fuso padrão do n8n é `America/New_York`. `GENERIC_TIMEZONE` muda isso. O nó Schedule lê esse valor para saber quando o workflow começa.

O modelo tem um input `TIMEZONE`. O padrão é `UTC`. Ele grava esse valor em `GENERIC_TIMEZONE` e em `TZ`. Um agendamento neste modelo roda em UTC, a menos que você defina `TIMEZONE` no deploy ou defina um fuso no workflow.

O modelo avisa que triggers de agendamento e de polling rodam dentro do processo do n8n, então o serviço precisa continuar no ar se você depende deles. O modelo é um serviço de imagem com volume persistente, e os dois ficam em uma única réplica. Aumente a memória na aba Scale do serviço quando um workflow precisar de mais. Você não adiciona uma segunda réplica. Serviços de imagem e serviços com volume persistente ficam sempre ligados. O sleep do On-demand não está disponível para eles.

## Backups e atualizações

A nota de backup do n8n pede duas cópias: a pasta de usuário e o banco externo quando você usa PostgreSQL. As credenciais no banco estão criptografadas. Um restore que não inclui a chave de criptografia não consegue descriptografá-las. O n8n recomenda um backup completo antes de uma atualização. Carregue esse backup uma vez antes de chamá-lo de plano. Um arquivo que você nunca restaurou não é um restore.

Na Unbroker, os dados do n8n são o volume de 1 GiB montado em `/data`. O Postgres tem o próprio volume de 1 GiB. Um volume sobrevive a um novo deploy, a um restart e a um rollback do código. Reset, detach e apagar o serviço removem os dados do volume. Backups de volume vão para um bucket compatível com S3 que você controla, num horário que você define, e exigem Pro. Imagens reconhecidas como Postgres, inclusive `pgvector/pgvector`, recebem backups com `pg_dump`. O preset de Postgres do Apps roda `pgvector/pgvector:pg16`. O caminho do volume está em [armazenamento persistente](https://unbroker.cloud/solutions/persistent-files).

O modelo fixa `n8nio/n8n:2.44.1`. Saia dessa tag só depois que um restore do volume e do banco tiver funcionado.

## Rodar na Unbroker

O [modelo n8n](https://unbroker.cloud/templates/n8n) faz o deploy do contêiner, do Postgres privado, dos volumes, da chave de criptografia gerada e da URL pública de webhook descritos acima. Você ainda opera essa cópia. Não é o produto hospedado do n8n.

Contêineres, bancos e volumes persistentes exigem Pro. O Pro custa $25 por mês com $25 de crédito de uso. O crédito reinicia a cada ciclo e não passa para o seguinte. O uso acima do crédito é cobrado à parte. O Free não inclui volumes persistentes nem imagens de contêiner, então este modelo não é um deploy do Free. [Preços](https://unbroker.cloud/pt/precos) é a página do plano. O resto do catálogo está em [modelos](https://unbroker.cloud/templates).

<aside class="plan-box">
<p><strong>Na Unbroker.</strong> Faça o deploy a partir do modelo quando você quer esse arranjo já ligado. Guarde a chave de criptografia, aponte um domínio próprio para as duas variáveis de URL e restaure um backup uma vez antes de tratar como produção.</p>
</aside>

## Perguntas frequentes

### O que eu preciso para um n8n self-hosted?

O contêiner do n8n, Postgres no lugar do arquivo SQLite padrão, um volume persistente para a pasta de usuário do n8n, uma chave de criptografia que você define uma vez e guarda, e uma URL pública para os webhooks. O [modelo n8n](https://unbroker.cloud/templates/n8n) monta esse arranjo na Unbroker.

### Por que Postgres em vez de SQLite no n8n?

SQLite é o padrão. O n8n grava credenciais, execuções antigas e workflows em ~/.n8n/database.sqlite se você não configurar um banco. PostgreSQL é o banco de servidor que o n8n suporta. Defina DB_TYPE como postgresdb e as variáveis DB_POSTGRESDB_HOST, DB_POSTGRESDB_PORT, DB_POSTGRESDB_DATABASE, DB_POSTGRESDB_USER e DB_POSTGRESDB_PASSWORD. O n8n não recomenda queue mode com SQLite, e uma fila distribuída sobre SQLite não é suportada.

### O que acontece se eu perder a chave de criptografia do n8n?

As credenciais gravadas ficam ilegíveis. O n8n criptografa as credenciais antes de gravá-las. N8N_ENCRYPTION_KEY é a chave da instância. Se você não definir uma, o n8n gera uma aleatória na primeira inicialização. Um banco restaurado não pode ser descriptografado sem essa mesma chave. O modelo da Unbroker gera a chave. Não mude nem apague.

### Qual variável define a URL de webhook do n8n?

A documentação atual do n8n chama de N8N_WEBHOOK_URL. Ela define a URL base dos webhooks de teste e de produção atrás de um proxy reverso. WEBHOOK_URL é um alias descontinuado desde o n8n 2.35.0. Ainda funciona, e o n8n registra um aviso na inicialização. O modelo da Unbroker define WEBHOOK_URL e N8N_EDITOR_BASE_URL com a URL pública do serviço. Atualize as duas se você adicionar um domínio próprio.

### Quem vira owner de um n8n self-hosted?

A conta criada na tela de cadastro na primeira vez que você abre o n8n. Essa conta é o owner da instância. A senha precisa ter pelo menos oito caracteres, com um número e uma letra maiúscula. No modelo da Unbroker, a primeira pessoa que abre a URL fica com esse cadastro, então abra você mesmo assim que o serviço estiver no ar.

### Como evito que as execuções do n8n encham o banco?

O n8n poda execuções concluídas por padrão. EXECUTIONS_DATA_PRUNE começa em true. EXECUTIONS_DATA_MAX_AGE começa em 336 horas (14 dias). EXECUTIONS_DATA_PRUNE_MAX_COUNT começa em 10000, e 0 significa sem limite por quantidade. Execuções new, running ou waiting não são podadas. Execuções anotadas nunca são podadas. O modelo da Unbroker não define essas variáveis, então valem os padrões.

### Qual plano um n8n self-hosted precisa na Unbroker?

Pro. Contêineres de modelo, bancos e volumes persistentes exigem Pro. O Pro custa $25 por mês com $25 de crédito de uso, e o uso é cobrado à parte. O Free não inclui volumes persistentes nem imagens de contêiner. O Postgres do modelo é um serviço de Apps que você opera, não um Postgres gerenciado. Veja [preços](https://unbroker.cloud/pt/precos) e [Postgres gerenciado](https://unbroker.cloud/managed-databases/postgres).

## Related reading

- [Fazer deploy do n8n](https://unbroker.cloud/templates/n8n)
- [Postgres gerenciado](https://unbroker.cloud/managed-databases/postgres)
- [Postgres em produção](https://unbroker.cloud/pt/blog/postgres-in-production)
- [Armazenamento persistente](https://unbroker.cloud/solutions/persistent-files)
- [Preços](https://unbroker.cloud/pt/precos)
- [Modelos de aplicativos](https://unbroker.cloud/templates)
