No canvas há cinco blocos, mas ao exportar para JSON restam apenas nodes e connections. Este artigo decompõe quatro termos: por que o nome do nó é a chave primária, qual camada do array de conexões é o índice de saída, por que o registro de execução ainda carrega o nome antigo do nó, e no final anexa cinco mensagens de erro reais originais.

Onde o n8n costuma travar não é no n8n, mas no Docker que vem antes. Este artigo aborda apenas quatro termos: image, container, volume e port, com um conjunto de comandos que rodam direto, além de seis armadilhas que você realmente vai encontrar — incluindo aquela que não dá erro, só faz todos os workflows desaparecerem no dia seguinte.

Quando o n8n não inicia, a linha em que o log para determina qual comando você deve executar. Porta ocupada, EADDRNOTAVAIL, ECONNREFUSED, módulo SQLite ausente, diretório .n8n sem permissão de escrita, cinco tipos de erro com o texto original e a forma correspondente de verificação, incluindo aquela mensagem que induz ao erro "será que já existe outro n8n em execução".

Construir o primeiro fluxo n8n a partir de uma tela em branco: acionamento manual para criar um dado, nó de edição de campos para adicionar os quatro campos da cotação, nó de código para calcular o preço total com frete. Inclui o JSON do workflow pronto para colar e importar, e a armadilha de tipo que calcula 430 como 37060.

No mesmo fluxo, o Zapier cobra por número de ações, o Make cobra por número de módulos e o n8n conta o fluxo inteiro como uma vez. Vou detalhar a conta com três cenários reais, incluir o tempo de manutenção do self-hosted e as restrições de licença, e por fim deixar claro em quais casos não recomendo escolher o n8n.

Depois de fazer login no n8n, o que cada área realmente significa: navegação à esquerda, botões na tela, entrada e saída após clicar duas vezes em um nó, status e milissegundos no histórico de execução. Inclui capturas de tela reais da interface, quatro ações de verificação e seis armadilhas comuns para iniciantes.

Três métodos de instalação — Docker, Docker Compose e npm — explicados passo a passo: como montar volumes de dados para não perder nada, por que o fuso horário continua errado mesmo depois de configurado, e qual a causa do login que fica girando sem parar, com quatro critérios de aceitação de "instalação bem-sucedida" e tratamento de erros comuns.

Explicar em linguagem simples o que o n8n faz: o que são nós, conexões e workflows, qual a diferença em relação ao Zapier, Make e escrever scripts próprios, quais tarefas são adequadas para delegar a ele e como aprender do zero. Inclui capturas de tela de workflows reais em execução.