Aprenda a usar o n8n com Docker e como instalar

O que é n8n e por que usar via Docker

O n8n é uma plataforma de automação de processos que funciona através de uma interface gráfica bem amigável. Você cria o que chamamos de “workflows” (fluxos de trabalho) conectando diversos serviços usando pequenos blocos chamados “nós” ou “nodes”. Cada nó representa uma ação específica: pode ser enviar um e-mail, buscar dados de uma planilha, postar algo nas redes sociais ou até mesmo processar informações de um jeito específico.

Agora você deve estar se perguntando: “Ok, entendi o que é o n8n, mas por que rodar ele especificamente através do Docker?” Existem algumas razões bem práticas para isso.

• Portabilidade: os containers Docker são isolados do sistema operacional e podem ser executados em qualquer máquina que tenha Docker instalado, facilitando a migração do n8n entre diferentes ambientes (desenvolvimento, produção, testes);
• Isolamento: o Docker cria um ambiente próprio para o n8n, evitando conflitos com outras aplicações ou bibliotecas instaladas no sistema, mantendo tudo organizado;
• Gerenciamento de versões: é fácil atualizar, reverter ou trocar versões do n8n simplesmente alterando a imagem Docker usada, sem complicações de dependências manuais.

Como instalar n8n no Docker

Antes de começar a automatizar tarefas com o n8n, você precisa preparar o ambiente no seu computador. Parece complicado à primeira vista, mas vou te guiar por cada etapa.

Para Windows e macOS: a forma mais simples é baixar o Docker Desktop direto do site oficial. Depois de instalar, não esqueça de abrir o Docker Desktop pelo menos uma vez para garantir que tudo está funcionando.

Para Linux (usando Ubuntu como exemplo): abra o terminal e digite esses comandos:

sudo apt update

sudo apt install docker.io

O primeiro comando atualiza a lista de programas disponíveis, enquanto o segundo instala o Docker propriamente dito.

Docker: a solução para ambientes de desenvolvimento

Passo a passo para criar um container n8n

1. Criar um volume para guardar seus dados:

Quando você cria workflows no n8n, essas informações precisam ficar salvas em algum lugar. Se não criar esse volume, toda vez que você parar o contêiner, perde tudo que fez.

Digite no terminal:

docker volume create n8n_data

Pronto, você criou um espaço dedicado para os dados do n8n.

2. Rodar o contêiner do n8n:

Agora vem o comando principal:

docker run -it --rm \
  --name n8n \
  -p 5678:5678 \
  -e GENERIC_TIMEZONE="America/Sao_Paulo" \
  -e N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS=true \
  -e N8N_RUNNERS_ENABLED=true \
  -v n8n_data:/home/node/.n8n \
  n8nio/n8n

docker run -it --rm \
  --name n8n \
  -p 5678:5678 \
  -e GENERIC_TIMEZONE="America/Sao_Paulo" \
  -e N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS=true \
  -e N8N_RUNNERS_ENABLED=true \
  -v n8n_data:/home/node/.n8n \
  n8nio/n8n

Vamos destrinchar cada linha:

• -it: deixa o contêiner rodar de forma interativa, ou seja, você vê o que está acontecendo no terminal;
• –rm: remove o contêiner automaticamente quando você pará-lo (útil para testes, mas você pode tirar essa parte se quiser manter o contêiner);
• –name n8n: simplesmente dá o nome “n8n” para o contêiner, porque fica mais fácil identificar depois;
• -p 5678:5678: essa é crucial – mapeia a porta 5678 do contêiner para a mesma porta no seu computador, permitindo que você acesse o n8n pelo navegador;
• -e …: essas linhas configuram variáveis de ambiente, como fuso horário (America/Sao_Paulo) e algumas permissões de segurança;
• -v n8n_data:/home/node/.n8n: conecta aquele volume que criamos antes ao contêiner;
• n8nio/n8n: a imagem oficial do n8n que o Docker vai baixar e usar.

Depois de executar esse comando, aguarde um pouquinho enquanto o Docker baixa a imagem (só acontece na primeira vez). Quando estiver pronto, você pode acessar o n8n abrindo seu navegador e indo em:

http://localhost:5678

Usando Docker Compose para facilitar sua vida

Digitar aquele comando gigante toda vez que quiser iniciar o n8n não é nada prático, então existe uma forma melhor: o Docker Compose.

1. Crie um arquivo chamado docker-compose.yml:

Você pode criar esse arquivo com qualquer editor de texto. O conteúdo deve ser:

version: '3.8'

services:
  n8n:
    image: n8nio/n8n
    restart: unless-stopped
    ports:
      - '5678:5678'
    volumes:
      - n8n_data:/home/node/.n8n
    environment:
      - GENERIC_TIMEZONE=America/Sao_Paulo
      - N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS=true
      - N8N_RUNNERS_ENABLED=true

volumes:
  n8n_data:

version: '3.8'

services:
  n8n:
    image: n8nio/n8n
    restart: unless-stopped
    ports:
      - '5678:5678'
    volumes:
      - n8n_data:/home/node/.n8n
    environment:
      - GENERIC_TIMEZONE=America/Sao_Paulo
      - N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS=true
      - N8N_RUNNERS_ENABLED=true

volumes:
  n8n_data:

A vantagem aqui é que tudo fica organizado e legível. Além disso, o restart: unless-stopped garante que o n8n inicie automaticamente se o Docker for reiniciado.

2. Para iniciar o n8n em segundo plano:

Navegue até a pasta onde salvou o arquivo docker-compose.yml e execute:

docker-compose up -d

O -d significa “detached”, ou seja, o contêiner roda em segundo plano e você pode continuar usando o terminal normalmente.

3. Acessando o n8n:

Igual antes, abra o navegador e vá em:

http://localhost:5678

4. Para parar o contêiner quando não estiver usando:

É simples, apenas digite:

docker-compose down

E pronto! Seu ambiente está configurado. Agora toda vez que você quiser usar o n8n, é só rodar docker-compose up -d e pronto. 

Containers: transformando o desenvolvimento em Python

Vantagens de usar Docker para rodar o n8n

Você pode até instalar o n8n diretamente no seu sistema operacional, mas usar Docker traz uma série de benefícios que fazem toda a diferença na prática, especialmente quando você começa a usar a ferramenta de forma mais séria. Vamos explorar por que vale tanto a pena seguir esse caminho.

• Escalabilidade: Docker permite criar múltiplos containers do n8n para aumentar a capacidade conforme a demanda, ideal para ambientes que crescem e precisam de alta disponibilidade.
• Portabilidade: com Docker, o n8n fica encapsulado em um container que pode ser facilmente movido entre diferentes ambientes (desenvolvimento, teste, produção) sem problemas de compatibilidade.
• Facilidade de instalação e manutenção: o uso de containers simplifica a instalação e a configuração do n8n, além de facilitar atualizações e rollbacks, reduzindo tempo de inatividade.
• Isolamento e segurança: Containers isolam o ambiente do n8n, evitando conflitos com outras aplicações no servidor e proporcionando maior segurança.
• Consistência de ambiente: o Docker garante que o n8n funcione da mesma forma em qualquer máquina, eliminando problemas do tipo “funciona na minha máquina”.
• Otimização de recursos: Containers são leves e eficientes, possibilitando melhor uso dos recursos do servidor e redução de custos com infraestrutura.
• Flexibilidade para automações complexas: com o ambiente controlado e fácil de replicar, equipes podem desenvolver, testar e implantar fluxos complexos rapidamente, ampliando a potencialidade das automações.

n8n vs Zapier: qual é a melhor ferramenta de automação?

Exemplos práticos de automações com n8n 

Sistema de Categorização de Contatos WhatsApp

Se você trabalha com atendimento pelo WhatsApp, sabe como é difícil organizar todos aqueles contatos e mensagens que chegam o tempo todo. Esse projeto resolve exatamente esse problema de uma forma bem inteligente.

Primeiro, você configura um Webhook no n8n. Pense nele como uma “porta de entrada” que fica esperando mensagens chegarem. Essas mensagens vêm através da Z-API, que é uma API gratuita (embora não oficial) do WhatsApp. Toda vez que alguém te manda mensagem, o Webhook captura isso em tempo real.

O resultado? Você tem uma base de contatos organizada, categorizada por tipo de interesse, com histórico de quando chegou e do que precisava. Tudo isso acontece automaticamente, sem você precisar ficar copiando e colando informações manualmente. É uma economia de tempo absurda, principalmente se você recebe muitas mensagens por dia.

Se você trabalha com atendimento via WhatsApp e quer trazer mais organização, inteligência e eficiência pro seu processo, esse projeto é praticamente obrigatório.

Salvamento e Categorização de Contatos pelo WhatsApp

Banco de integrações: conectando n8n com qualquer ferramenta

Uma das coisas que mais toma tempo quando você começa a usar o n8n é configurar as integrações com os serviços que você já usa. Como conectar com o Gmail? E com o Google Drive? Como pegar as credenciais da API da OpenAI? Cada ferramenta tem suas particularidades, e descobrir isso sozinho pode ser bem frustrante.

É aí que entra o Banco de Integrações, um curso prático que te entrega de bandeja templates prontos e instruções claras para conectar o n8n com dezenas de ferramentas populares. Você recebe o passo a passo de como conseguir as credenciais necessárias, boas práticas de configuração e workflows já testados que você pode adaptar pro seu caso específico.

Banco de Integrações com n8n

Funil de captação com clone de voz usando ElevenLabs

Esse aqui é um dos projetos mais impressionantes que você pode fazer com n8n, porque mistura automação com tecnologia de ponta de um jeito que realmente surpreende.

Você constrói um funil automático de captação de leads (ou seja, potenciais clientes) que funciona sozinho do começo ao fim. A jornada completa acontece assim: uma pessoa visita sua página de inscrição e deixa as informações dela (nome, e-mail e WhatsApp). Esses dados são salvos automaticamente numa planilha do Google Sheets. 

Então um agente de inteligência artificial analisa as informações daquela pessoa específica e cria uma mensagem personalizada considerando o contexto do lead.

Funil Automático de Captação de Leads com clone de voz (ElevenLabs + WhatsApp)

Como criar um agente de IA usando n8n: guia passo a passo

Comece sua jornada de automação hoje

Você tem duas opções agora:

1. Fechar esta página, pensar “isso foi interessante” e continuar fazendo tudo manualmente como sempre fez;

2. Tomar a decisão de realmente mudar a forma como trabalha, aprendendo habilidades que vão te diferenciar no mercado e liberar seu tempo para coisas mais importantes.

Conheça a Trilha Automatizando Tudo com n8n e comece hoje mesmo sua jornada rumo à automação inteligente. Cada dia que você adia é mais tempo perdido em tarefas repetitivas que uma máquina poderia estar fazendo por você.

O futuro do trabalho é automatizado. A questão é: você vai fazer parte desse futuro ou ficar assistindo de fora?

Trilha Automatizando Tudo com N8N

Domine a ferramenta de automação mais utilizada do mundo sem precisar programar.

Comece agora