n8n 2.39.6 corrige validação de créditos do Gateway e prepara mudança no diretório de armazenamento

O n8n 2.39.6 foi lançado em 16 de setembro de 2026. A nota oficial da versão documenta uma correção no núcleo do produto e duas mudanças voltadas à preparação de migrações e à identificação de configuração obsoleta.

O que muda no n8n 2.39.6

A correção registrada para esta versão faz com que a elegibilidade de créditos do Gateway seja verificada no subnó correto. Para fluxos que dependem dessa validação, a alteração busca garantir que a análise ocorra no componente associado à configuração em uso.

A nota de versão não detalha cenários de falha, critérios de elegibilidade nem configurações adicionais afetadas. Por isso, não é possível afirmar um impacto além da correção oficialmente descrita.

Regra de compatibilidade para a mudança no diretório de armazenamento

O n8n 2.39.6 adiciona uma regra de mudança incompatível para a versão 3 relacionada à renomeação do diretório de armazenamento. Uma mudança incompatível é uma alteração que pode exigir adaptação antes de uma atualização de versão principal.

A release confirma a inclusão da regra, mas não apresenta nesta nota os nomes dos diretórios, as etapas de migração ou o calendário da mudança. Administradores que planejam a transição para a versão 3 devem acompanhar a documentação oficial do n8n e validar o armazenamento persistente do ambiente antes da atualização principal.

Aviso para N8N_DB_PING_TIMEOUT

Outra alteração adiciona um aviso para a variável de ambiente N8N_DB_PING_TIMEOUT, marcada como obsoleta. O aviso permite identificar instalações que ainda dependem dessa configuração.

A nota oficial não informa uma variável substituta nem uma data de remoção. Portanto, a ação adequada é registrar o uso atual dessa variável e consultar a documentação oficial antes de alterá-la ou removê-la.

Impacto para quem atualiza da versão 2.38.7

Para uma instalação na versão 2.38.7 que adota a 2.39.6, esta release deve ser avaliada como destino da atualização. As alterações acima descrevem especificamente o que foi publicado na 2.39.6; o intervalo entre as versões contém outras releases, cujos detalhes devem ser consultados individualmente nas fontes oficiais.

Conclusão

O n8n 2.39.6 tem escopo documentado e objetivo: corrigir a validação de créditos do Gateway no subnó adequado, adicionar uma regra de compatibilidade para a futura renomeação do diretório de armazenamento e alertar sobre o uso de uma variável de ambiente obsoleta. Antes de atualizar ambientes críticos, valide integrações, variáveis de ambiente e volumes persistentes em um ambiente de teste.

Fontes oficiais