Instale o Docker no seu computador: Windows, macOS e Linux

O n8n roda dentro de um container Docker. Antes de instalar a instância de estudo, você precisa do Docker instalado e do servidor Docker em execução. O script oficial de uma linha também exige o plugin Compose v2, chamado com docker compose.

Windows com Docker Desktop

Abra a instalação oficial para Windows, confira os requisitos e baixe o instalador para a arquitetura do computador. Execute o instalador e siga as instruções para habilitar o WSL 2 quando solicitado. Depois, abra o Docker Desktop pelo menu do Windows e conclua a configuração inicial.

Para usar o script de uma linha do n8n, abra um terminal WSL com a integração do Docker Desktop habilitada para sua distribuição. Essa integração fica em Settings > Resources > WSL Integration. O comando do script usa shell POSIX e não deve ser colado diretamente no PowerShell ou no Prompt de Comando.

macOS com Docker Desktop

Na página oficial para Mac, escolha Apple silicon ou Intel conforme o processador. Abra o arquivo de instalação, arraste o Docker para Applications e inicie o aplicativo. Complete as instruções exibidas antes de abrir o terminal para conferir a instalação.

Linux com Desktop ou Engine

Você pode instalar o Docker Desktop para Linux em uma distribuição suportada. Outra opção é o Docker Engine, seguindo o procedimento específico da distribuição e instalando também o plugin Compose. Os comandos de instalação variam entre distribuições, por isso use a página correspondente ao seu sistema.

Confira no terminal que você vai usar

Execute estes comandos no terminal destinado à instalação do n8n:

1
docker --version
2
docker compose version
3
docker info

O primeiro identifica o cliente instalado. O segundo confirma o Compose v2. No terceiro, procure a seção Server: ela mostra que o cliente conseguiu consultar o servidor Docker.

Se houver erro de conexão, confira se o Docker Desktop ou o serviço Docker Engine está iniciado. Se houver erro de permissão, reveja o acesso ao Docker conforme o procedimento da sua distribuição. Só avance para instalar o n8n quando os três comandos funcionarem nesse mesmo terminal.