Variáveis de ambiente: Binary data e armazenamento externo
26 variáveis das versões 1.123.92, 2.45.7 e 3.0.1
Onde o n8n guarda arquivos binários: no disco, no banco ou em S3 e Azure. Inclui caminho, tamanho máximo e validade. A lista sai do código de cada versão e das páginas de variáveis da documentação oficial, conferidos em 3 de novembro de 2026. Toda variável aceita o sufixo _FILE para ler o valor de um arquivo, útil para senhas e chaves em secrets do Docker.
Listava os modos de binary data disponíveis na 1.x.
Na 2.x e na 3.x, o n8n pede para remover a variável porque ela não tem mais efeito.
Tamanho máximo em MiB de cada arquivo de binary data no modo
database.Nome antigo do modo de binary data, anterior a
N8N_DEFAULT_BINARY_DATA_MODE. O código das três linhas não lê mais a variável.Na 1.x, o n8n avisava que o valor
defaultestava defasado e pedia o modofilesystem.Segredo usado para assinar as URLs públicas de binary data. Sem valor, o n8n deriva o segredo da chave de criptografia da instância.
Pasta do binary data no modo
filesystem. Na 2.x e na 3.x, foi substituída porN8N_STORAGE_PATH.Na 2.x e na 3.x, o n8n pede para usar
N8N_STORAGE_PATH.Definia a validade do binary data temporário em versões antigas. Não tem mais efeito.
Nas três linhas, o n8n pede para remover a variável porque ela não tem mais efeito.
Onde o n8n guarda o binary data:
filesystem,database,s3ouazure. Sem valor, a 2.x e a 3.x usamfilesystemno modo regular edatabaseno queue mode. O modofilesystemnão funciona com queue mode. O valordefault, em memória, foi removido na 3.x.Na 2.x, o n8n avisa que o modo
defaultserá removido. Na 3.x, o valordefaulté ignorado e o n8n passa a usarfilesystem, oudatabaseno queue mode.Chave da storage account do Azure, usada junto de
N8N_EXTERNAL_STORAGE_AZURE_ACCOUNT_NAME.Nome da storage account do Azure, usado com a chave ou com identidade gerenciada.
Autentica no Azure pelo
DefaultAzureCredential, com identidade gerenciada, variáveis de ambiente ou Azure CLI. Com a opção ligada, o n8n ignora a chave da storage account.Connection string do Azure Blob Storage. Quando definida, tem prioridade sobre nome e chave da storage account. É a opção mais simples para testes locais com o Azurite.
Nome do container do Azure Blob que guarda os resultados das execuções e o binary data.
Endpoint personalizado do Azure Blob, como o do Azurite ou de uma nuvem soberana.
Access key do armazenamento compatível com S3.
Secret key do armazenamento compatível com S3.
Autentica no S3 pela cadeia padrão de credenciais da AWS, como perfil da instância ou variáveis de ambiente, ignorando access key e secret.
Nome do bucket do n8n no armazenamento compatível com S3.
Região do bucket, como
us-east-1.Usa endereçamento por caminho (
https://host/bucket) no lugar do subdomínio (https://bucket.host). Necessário em serviços como MinIO.Host do bucket, como
s3.us-east-1.amazonaws.comou o endereço do MinIO.Quantidade máxima de tentativas de cada requisição ao S3.
Protocolo usado para acessar o bucket:
httpouhttps.Tempo em milissegundos da checagem de conexão com o bucket na inicialização. Com
0, o limite fica desligado.Controlava, na 2.x, a migração da pasta
binaryDataparastorage. A 3.x renomeia a pasta na primeira inicialização e remove a variável.Definia a validade do binary data persistido em versões antigas. Não tem mais efeito.
Nas três linhas, o n8n pede para remover a variável porque ela não tem mais efeito.
Pasta-base do armazenamento em
filesystem. O padrão é~/.n8n/storage. Na 3.x, o n8n renomeia~/.n8n/binaryDataparastoragena primeira inicialização e não inicia se as duas pastas existirem. Defina esta variável com o caminho antigo para manter a pasta atual.