Como configurar PostgreSQL no n8n e limpar histórico de execuções (Prune)

1. Arquitetura e pré-requisitos no ambiente

Por padrão em instalações caseiras, o n8n utiliza SQLite, que trava em leituras e escritas concorrentes. Em produção na VPS NVMe, usar PostgreSQL com política de retenção garante velocidade constante mesmo após milhões de execuções.

• Container postgres:16-alpine na mesma rede Docker do n8n.
• Volume persistente dedicado para /var/lib/postgresql/data.
• Backup prévio dos workflows e credenciais via CLI (n8n export:workflow --all).

2. Passo a passo de implementação e validação

1. Configure no .env do n8n: DB_TYPE=postgresdb, DB_POSTGRESDB_HOST=postgres, DB_POSTGRESDB_DATABASE=n8n, DB_POSTGRESDB_USER=n8n e DB_POSTGRESDB_PASSWORD=SENHA_FORTE.
2. Habilite a limpeza automática com EXECUTIONS_DATA_PRUNE=true, EXECUTIONS_DATA_MAX_AGE=72 (horas) e EXECUTIONS_DATA_PRUNE_MAX_COUNT=25000.
3. Nos workflows de alta frequência (como webhooks de status de leitura), desative o salvamento de execuções bem-sucedidas em Workflow Settings > Save Successful Executions: Do Not Save.
4. Reinicie a stack e valide a criação das tabelas no PostgreSQL.

3. Boas práticas de produção, segurança e escala

Caso sua tabela execution_entity já esteja gigante antes de ativar o prune, execute VACUUM FULL execution_entity; em janela de manutenção para devolver o espaço livre ao SSD NVMe.

• Mantenha EXECUTIONS_DATA_SAVE_ON_ERROR=all ativo para nunca perder o diagnóstico de falhas.
• Externalize anexos e áudios para o Storage S3 da You Secure.