Ir para o conteúdo
Promovaweb

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.

    Tipo
    String
    Padrão
    filesystem
    Versões
    1.x aceita2.x não aceita3.x não aceita
  • Tamanho máximo em MiB de cada arquivo de binary data no modo database.

    Tipo
    Number
    Padrão
    512
    Versões
    1.x aceita2.x aceita3.x aceita
  • N8N_BINARY_DATA_MODE
    • Fora do código atual
    • Fora da documentação

    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 default estava defasado e pedia o modo filesystem.

    Tipo
    String
    Padrão
    sem padrão
    Versões
    1.x não aceita2.x não aceita3.x não aceita
  • N8N_BINARY_DATA_SIGNING_SECRET
    • Fora da documentação

    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.

    Tipo
    String
    Padrão
    calculado pelo n8n
    Versões
    1.x aceita2.x aceita3.x aceita
  • Pasta do binary data no modo filesystem. Na 2.x e na 3.x, foi substituída por N8N_STORAGE_PATH.

    Na 2.x e na 3.x, o n8n pede para usar N8N_STORAGE_PATH.

    Tipo
    String
    Padrão
    N8N_USER_FOLDER/binaryData
    Versões
    1.x aceita2.x aceita3.x aceita
  • N8N_BINARY_DATA_TTL
    • Fora do código atual
    • Fora da documentação

    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.

    Tipo
    String
    Padrão
    sem padrão
    Versões
    1.x não aceita2.x não aceita3.x não aceita
  • Onde o n8n guarda o binary data: filesystem, database, s3 ou azure. Sem valor, a 2.x e a 3.x usam filesystem no modo regular e database no queue mode. O modo filesystem não funciona com queue mode. O valor default, em memória, foi removido na 3.x.

    Na 2.x, o n8n avisa que o modo default será removido. Na 3.x, o valor default é ignorado e o n8n passa a usar filesystem, ou database no queue mode.

    Tipo
    String
    Padrão
    default
    Versões
    1.x aceita2.x aceita3.x aceita
  • Chave da storage account do Azure, usada junto de N8N_EXTERNAL_STORAGE_AZURE_ACCOUNT_NAME.

    Tipo
    String
    Padrão
    sem padrão
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Nome da storage account do Azure, usado com a chave ou com identidade gerenciada.

    Tipo
    String
    Padrão
    sem padrão
    Versões
    1.x não aceita2.x aceita3.x aceita
  • 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.

    Tipo
    Boolean
    Padrão
    false
    Versões
    1.x não aceita2.x aceita3.x aceita
  • 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.

    Tipo
    String
    Padrão
    sem padrão
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Nome do container do Azure Blob que guarda os resultados das execuções e o binary data.

    Tipo
    String
    Padrão
    sem padrão
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Endpoint personalizado do Azure Blob, como o do Azurite ou de uma nuvem soberana.

    Tipo
    String
    Padrão
    sem padrão
    Versões
    1.x não aceita2.x aceita3.x aceita
  • Access key do armazenamento compatível com S3.

    Tipo
    String
    Padrão
    sem padrão
    Versões
    1.x aceita2.x aceita3.x aceita
  • Secret key do armazenamento compatível com S3.

    Tipo
    String
    Padrão
    sem padrão
    Versões
    1.x aceita2.x aceita3.x aceita
  • 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.

    Tipo
    Boolean
    Padrão
    false
    Versões
    1.x aceita2.x aceita3.x aceita
  • Nome do bucket do n8n no armazenamento compatível com S3.

    Tipo
    String
    Padrão
    sem padrão
    Versões
    1.x aceita2.x aceita3.x aceita
  • Região do bucket, como us-east-1.

    Tipo
    String
    Padrão
    sem padrão
    Versões
    1.x aceita2.x aceita3.x aceita
  • Usa endereçamento por caminho (https://host/bucket) no lugar do subdomínio (https://bucket.host). Necessário em serviços como MinIO.

    Tipo
    Boolean
    Padrão
    true
    Versões
    1.x aceita2.x aceita3.x aceita
  • Host do bucket, como s3.us-east-1.amazonaws.com ou o endereço do MinIO.

    Tipo
    String
    Padrão
    sem padrão
    Versões
    1.x aceita2.x aceita3.x aceita
  • Quantidade máxima de tentativas de cada requisição ao S3.

    Tipo
    Number
    Padrão
    3
    Versões
    1.x aceita2.x aceita3.x aceita
  • N8N_EXTERNAL_STORAGE_S3_PROTOCOL
    • Fora da documentação

    Protocolo usado para acessar o bucket: http ou https.

    Tipo
    Enum
    Padrão
    https
    Versões
    1.x aceita2.x aceita3.x aceita
    Valores
    • http
    • https
  • Tempo em milissegundos da checagem de conexão com o bucket na inicialização. Com 0, o limite fica desligado.

    Tipo
    Number
    Padrão
    10000
    Versões
    1.x não aceita2.x aceita3.x aceita
  • N8N_MIGRATE_FS_STORAGE_PATH
    • Removida na 3.x
    • Fora da documentação

    Controlava, na 2.x, a migração da pasta binaryData para storage. A 3.x renomeia a pasta na primeira inicialização e remove a variável.

    Tipo
    String
    Padrão
    sem padrão
    Versões
    1.x não aceita2.x aceita3.x não aceita
  • N8N_PERSISTED_BINARY_DATA_TTL
    • Fora do código atual
    • Fora da documentação

    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.

    Tipo
    String
    Padrão
    sem padrão
    Versões
    1.x não aceita2.x não aceita3.x não aceita
  • Pasta-base do armazenamento em filesystem. O padrão é ~/.n8n/storage. Na 3.x, o n8n renomeia ~/.n8n/binaryData para storage na 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.

    Tipo
    String
    Padrão
    N8N_USER_FOLDER/storage
    Versões
    1.x não aceita2.x aceita3.x aceita