Ambiente completo do workshop com n8n em queue mode, PostgreSQL, Redis e Evolution API — tudo em um único docker compose up.
Windows: abra o Docker Desktop antes de rodar os comandos abaixo.
macOS / Linux:
git clone https://github.com/LeoZanini/workshop-n8n.git
cd workshop-n8n
cp .env.example .env
docker compose up -dWindows (PowerShell):
git clone https://github.com/LeoZanini/workshop-n8n.git
cd workshop-n8n
Copy-Item .env.example .env
docker compose up -dn8n: http://localhost:5678
Evolution API: http://localhost:8080
- Docker Desktop instalado
- Docker Desktop deve estar aberto e rodando antes de qualquer comando Docker (verifique o ícone na bandeja do sistema — deve estar verde/ativo)
- Docker Engine + plugin Compose (sem necessidade de Docker Desktop):
# Ubuntu/Debian
sudo apt update && sudo apt install -y docker.io docker-compose-plugin
sudo usermod -aG docker $USER # adiciona seu usuário ao grupo docker
newgrp docker # aplica sem precisar fazer logoutWindows (PowerShell) / macOS / Linux:
git clone https://github.com/LeoZanini/workshop-n8n.git
cd workshop-n8nWindows (PowerShell):
Copy-Item .env.example .envmacOS / Linux:
cp .env.example .envO
.env.examplejá tem todos os valores preenchidos para o workshop. Após copiar, não é necessário alterar nada.
docker compose up -dNa primeira execução o Docker vai baixar todas as imagens (pode demorar alguns minutos). São 5 serviços no total:
| Serviço | URL | Descrição |
|---|---|---|
n8n |
http://localhost:5678 | Editor de workflows |
n8n-worker |
— | Processa execuções da fila (sem UI) |
evolution-api |
http://localhost:8080 | API WhatsApp |
postgres |
porta 5432 |
Banco de dados |
redis |
porta 6379 |
Fila e cache |
Abra o navegador e acesse:
http://localhost:5678
Na primeira vez, o n8n vai pedir para criar uma conta de administrador local. Preencha com qualquer e-mail e senha — esses dados ficam apenas na sua máquina.
| Ação | Comando |
|---|---|
| Subir o container | docker compose up -d |
| Parar o container | docker compose down |
| Ver logs em tempo real | docker compose logs -f |
| Reiniciar o container | docker compose restart |
| Atualizar o n8n | docker compose pull && docker compose up -d |
Os seus workflows, credenciais e configurações são armazenados em um volume Docker chamado n8n_data. Eles não são apagados quando você roda docker compose down. Para apagar tudo e começar do zero:
docker compose down -v
⚠️ O flag-vapaga o volume. Use com cuidado.
| Serviço | Versão |
|---|---|
| n8n | 2.17.7 |
| Evolution API | v2.2.3 |
| PostgreSQL | 16 |
| Redis | 7 |
Versões fixadas garantem que todos os alunos rodem o mesmo ambiente.
O n8n está configurado com EXECUTIONS_MODE=queue. Isso significa:
- O container
n8nsó serve a UI e a API - O container
n8n-workeré quem realmente executa os workflows - A comunicação entre eles passa pelo Redis (Bull queue)
Essa é a arquitetura de produção do n8n — horizontal scalable, com múltiplos workers.
Para ver os logs do worker:
docker compose logs -f n8n-workerA Evolution API expõe uma interface HTTP para enviar e receber mensagens do WhatsApp.
- URL: http://localhost:8080
- API Key:
workshop-evolution-key(definida no.env) - Docs interativas: http://localhost:8080/docs
Você vai precisar de um número de WhatsApp para parear (pode ser um número secundário ou chip de teste).
A pasta workflows/ contém os fluxos prontos de cada aula em formato .json.
- Abra o n8n em
http://localhost:5678 - Menu superior direito → Import from file
- Selecione o
.jsonda aula desejada - O workflow já vai aparecer com sticky notes explicando o conteúdo
workflows/
aula-01-hello-world.json ← primeiro workflow, só pra testar
aula-02-http-request.json ← chamando uma API externa
open //./pipe/dockerDesktopLinuxEngine: O sistema não pode encontrar o arquivo especificado (Windows)
O Docker Desktop não está rodando. Abra o Docker Desktop pela bandeja do sistema ou pelo menu Iniciar e aguarde o ícone ficar verde antes de rodar docker compose up -d.
Seu usuário não está no grupo docker. Rode:
sudo usermod -aG docker $USER
newgrp dockerAlgum outro processo está usando a porta. Para identificar:
# Linux/macOS
lsof -i :5678
# Windows (PowerShell)
netstat -ano | findstr :5678Encerre o processo conflitante ou edite o .env para trocar a porta.
Aguarde ~30 segundos — o PostgreSQL precisa inicializar antes do n8n conectar. Verifique:
docker compose logs -f n8n