Como Instalar o N8N com Docker no Ubuntu 24.04

Quer automatizar fluxos de trabalho de forma simples? Neste tutorial, mostramos como instalar o N8N com Docker no Ubuntu 24.04, ideal para quem está começando! O N8N é uma plataforma de automação de fluxos de trabalho que permite integrar diversos serviços e sistemas de forma visual e intuitiva. Utilizar o Docker para essa instalação proporciona um ambiente isolado, fácil de gerenciar e manter. Vamos lá?

O que Você Precisa

Antes de começar, você vai precisar de:

Sistema Ubuntu 24.04 (LTS, 64-bit): A versão mais recente do Ubuntu garante suporte e atualizações.
Docker: Ferramenta essencial para criar e gerenciar containers. Certifique-se de que está instalado (versão 20.10 ou superior).
Docker Compose: Utilitário que facilita a definição e gerenciamento de aplicações Docker multi-containers.

Passo 1: Preparar o Sistema

Passo 1.1: Atualizar Pacotes

Atualize os pacotes existentes para evitar erros de compatibilidade com o Docker.

sudo apt-get update && sudo apt-get upgrade

Você verá uma lista de pacotes sendo atualizados.

Passo 1.2: Remover Implementações Antigas do Docker

Caso tenha uma versão antiga do Docker instalada, remova-a com o seguinte comando:

sudo apt-get remove docker docker-engine docker.io containerd runc

Passo 1.3: Instalar Dependências Necessárias

Instale pacotes necessários que permitirão a adição do repositório do Docker.

sudo apt-get install ca-certificates curl gnupg lsb-release

Passo 1.4: Adicionar a Chave GPG do Docker

A segurança do Docker é uma prioridade, e você precisará adicionar a chave GPG do repositório.

sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg

Passo 1.5: Configurar o Repositório do Docker

Adicione o repositório Docker às suas fontes de pacotes.

echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

Passo 1.6: Instalar o Docker e o Docker Compose

Atualize novamente os pacotes e instale o Docker e o Docker Compose.

sudo apt-get update
sudo apt-get install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin

Após a instalação, verifique se tudo foi instalado corretamente:

docker --version
docker compose version

Passo 2: Instalar o N8N com Docker Compose

Com o Docker e o Docker Compose instalados, siga os passos abaixo para configurar o N8N.

Passo 2.1: Criar um Diretório para o N8N

Crie um diretório que será utilizado para armazenar os dados do N8N.

mkdir -p ~/n8n
cd ~/n8n

Passo 2.2: Criar o Arquivo Docker Compose

Utilize um editor de texto para criar o arquivo docker-compose.yml com o seguinte conteúdo:

version: "3.7"
services:
  n8n:
    image: docker.n8n.io/n8nio/n8n
    restart: always
    ports:
      - "127.0.0.1:5678:5678"
    environment:
      - N8N_HOST=localhost
      - N8N_PORT=5678
      - N8N_PROTOCOL=http
      - NODE_ENV=production
      - WEBHOOK_URL=http://localhost:5678/
      - GENERIC_TIMEZONE=America/Sao_Paulo
    volumes:
      - ./n8n_data:/home/node/.n8n
volumes:
  n8n_data:
    external: true

Este arquivo configura o contêiner do N8N para reiniciar automaticamente e usar um volume para a persistência de dados. Leia mais na documentação do N8N.

Passo 2.3: Criar o Diretório para Persistência de Dados

Crie o diretório onde os dados do N8N serão armazenados.

mkdir -p ~/n8n/n8n_data

Passo 2.4: Iniciar o Contêiner do N8N

Inicie o contêiner em segundo plano.

docker compose up -d

Passo 2.5: Acessar o N8N

Abra seu navegador e acesse http://localhost:5678. Você deverá ver a interface do N8N pronta para uso.

Erros Comuns e Soluções

Erros Comuns

**Erro 1: Permissão Negada no Docker**
Causa: O usuário não tem permissão para executar o Docker.
Solução: Adicione o usuário ao grupo Docker:

sudo usermod -aG docker $USER

Reinicie a sessão para aplicar as mudanças.

**Erro 2: Porta 5678 Já em Uso**
Causa: A porta padrão do N8N está ocupada.
Solução: Verifique a porta com:

sudo netstat -tuln | grep 5678

Altere a porta no arquivo de configuração do N8N conforme necessário.

**Erro 3: Docker não está rodando**
Causa: O serviço do Docker não está ativo.
Solução: Verifique o status do Docker:

systemctl status docker

Se não estiver ativo, inicie-o com:

sudo systemctl start docker

Conclusão

Parabéns! Seu N8N está rodando com Docker no Ubuntu 24.04, pronto para automatizar seus fluxos de trabalho. Lembre-se de que, para ambientes de produção, é recomendável configurar um banco de dados externo, como PostgreSQL, e utilizar HTTPS para garantir a segurança das conexões. Precisa de mais ajuda? Fale com a JFS!

Meta Description

Aprenda a instalar o N8N com Docker no Ubuntu 24.04. Tutorial detalhado com passos, erros comuns e soluções!

Palavras-chave

N8N, Docker, Ubuntu 24.04, tutorial TI, automação de fluxos, erros Docker.

“Como Instalar o N8N com Docker no Ubuntu 24.04 em 5 Passos”