Como Instalar o N8N com Dokploy na sua VPS em Minutos

O N8N é uma ferramenta de automação que permite conectar diferentes aplicações e criar fluxos de trabalho sem precisar programar.

Com ele, você pode automatizar tarefas, integrar sistemas, conectar APIs e criar processos que funcionam automaticamente.

Neste tutorial, vamos aprender a instalar o N8N em uma VPS utilizando o Dokploy.

A instalação será feita através de um template pronto, que configura automaticamente os principais serviços necessários para o funcionamento do N8N.

Você não precisa escrever um arquivo Docker Compose do zero nem executar vários comandos no terminal. Vamos fazer praticamente tudo pelo painel do Dokploy.

O que você precisa para instalar o N8N?

Antes de começar, você precisa ter:

• Uma VPS com Dokploy instalado.
• Acesso ao painel administrativo do Dokploy.
• Um projeto criado para organizar suas aplicações.

Para este tutorial, utilizaremos uma VPS com 2 GB de RAM e 2 CPUs.

Entretanto, para ter uma experiência melhor, especialmente utilizando o modo fila, é interessante considerar um servidor com pelo menos 4 GB de RAM.

1. Criando um projeto no Dokploy

Primeiro, acesse o painel administrativo do Dokploy.

No menu principal, procure a opção Projects.

Os projetos servem para organizar suas aplicações dentro do servidor.

Por exemplo, você pode criar projetos separados para:

• Automações.
• Sites.
• Aplicações dos seus clientes.
• Sistemas internos.

Para este exemplo, vamos criar um projeto chamado automacoes.

Clique em Create Project, informe o nome e confirme a criação.

Depois de criar o projeto, você encontrará o ambiente chamado Production.

O Dokploy também permite criar outros ambientes, como homologação e testes. Assim, você pode experimentar configurações antes de publicar uma aplicação oficialmente.

2. Selecionando o template do N8N

Agora que temos nosso projeto, vamos instalar o N8N.

Dentro do projeto, clique em:

Create Service → Template

O Dokploy possui diversos templates prontos para instalação de aplicações.

Na barra de pesquisa, digite:

N8N

Você encontrará diferentes opções de instalação.

Entre elas, temos versões com diferentes configurações de banco de dados, processamento e execução.

Neste tutorial, vamos utilizar o N8N em modo fila (Queue Mode).

Esse modo utiliza serviços separados para organizar e processar as execuções das automações.

Selecione o template de modo fila e clique em Create.

O Dokploy vai preparar toda a estrutura necessária para nossa instalação.

3. Entendendo os serviços do N8N

Depois de selecionar o template, o Dokploy apresentará a configuração da aplicação.

Antes de iniciar a instalação, é interessante entender quais serviços serão criados.

Neste exemplo, teremos quatro componentes principais:

N8N

É a aplicação principal.

É através dela que você acessa o painel administrativo e cria seus workflows.

PostgreSQL

É o banco de dados responsável por armazenar as informações do N8N.

Redis

É utilizado para gerenciar as filas de execução.

Ele ajuda a organizar as tarefas que precisam ser processadas pelos Workers.

Worker

É o serviço responsável por executar as tarefas recebidas pela fila.

Em vez de deixar todo o processamento concentrado na aplicação principal, podemos utilizar Workers separados.

Essa estrutura permite distribuir melhor o trabalho e aumentar a capacidade de processamento conforme a necessidade.

4. Configurando o Docker Compose

O template do Dokploy já traz um arquivo Docker Compose preparado.

Nele estão definidas as imagens, os serviços, as variáveis de ambiente e os volumes necessários.

Você encontrará configurações para:

• PostgreSQL.
• Redis.
• N8N.
• Worker.

Também existem configurações de volumes para manter os dados armazenados, mesmo quando os contêineres forem recriados.

Se você já possui experiência com Docker, poderá modificar esse arquivo e personalizar a instalação.

Mas, para este tutorial, vamos utilizar a configuração original do template.

Ajustando a quantidade de Workers

Na configuração do Worker, o template apresenta duas réplicas inicialmente.

Como nossa VPS possui apenas 2 GB de RAM e 2 CPUs, vamos reduzir essa quantidade para uma réplica.

Isso ajuda a evitar consumo desnecessário de recursos em um servidor mais limitado.

Depois de realizar a alteração, clique em Save.

5. Configurando as variáveis de ambiente

Agora vamos configurar algumas variáveis de ambiente.

No menu da aplicação, acesse:

Environment Variables

As variáveis de ambiente permitem modificar configurações da aplicação sem precisar alterar diretamente o código.

Neste exemplo, vamos ajustar o fuso horário.

Configurando o fuso horário

Localize a variável:

GENERIC_TIMEZONE

Altere o valor para:

GENERIC_TIMEZONE=America/Sao_Paulo

Essa configuração define o fuso horário utilizado pelo N8N.

É importante configurar corretamente essa opção para que os agendamentos e as automações utilizem o horário esperado.

As demais variáveis podem permanecer com os valores definidos pelo template.

Depois de finalizar, clique em Save.

6. Fazendo o Deploy do N8N

Agora que revisamos as configurações, chegou a hora de instalar nossa aplicação.

No painel do Dokploy, clique em:

Deploy

Confirme a operação.

O Dokploy começará a executar o processo de instalação.

Basicamente, ele vai:

1. Baixar as imagens Docker necessárias.
2. Criar os contêineres.
3. Configurar os serviços.
4. Inicializar o PostgreSQL e o Redis.
5. Iniciar o N8N e o Worker.

Você pode acompanhar todo o processo acessando a aba Deployments.

O tempo de instalação depende da velocidade da sua VPS e da conexão com a internet.

Quando tudo estiver funcionando corretamente, o status da aplicação ficará verde.

Problemas de memória durante a instalação

Durante o tutorial, foi utilizada uma VPS com 2 GB de RAM e 2 CPUs.

Entretanto, durante a inicialização dos serviços, algumas aplicações começaram a apresentar travamentos.

O problema foi resolvido com a criação de uma memória SWAP de 4 GB.

A SWAP utiliza parte do armazenamento da VPS como uma extensão da memória RAM.

Se sua VPS apresentar problemas de memória durante a instalação, essa configuração pode ajudar.

Lembre-se de que a SWAP não substitui a memória RAM. Para ambientes com mais automações e execuções simultâneas, considere utilizar uma VPS com mais recursos.

7. Conferindo os contêineres

Depois que o Deploy terminar, acesse a aba:

Containers

Você deverá encontrar os serviços criados pelo template.

No nosso exemplo:

Contêiner	Função
N8N	Interface principal e gerenciamento das automações
Worker	Processamento das tarefas
PostgreSQL	Banco de dados
Redis	Gerenciamento das filas

Se todos os contêineres estiverem funcionando, significa que nossa instalação foi concluída corretamente.

8. Acessando o N8N pelo navegador

Agora vamos acessar nossa instalação.

Dentro do serviço, procure a opção:

Domains

O Dokploy disponibiliza um domínio temporário automaticamente.

Isso permite acessar a aplicação sem precisar configurar um domínio próprio neste primeiro momento.

Clique no endereço disponibilizado.

O navegador abrirá a interface do N8N utilizando HTTPS.

Na primeira vez que acessar, será necessário realizar a configuração inicial.

Você deverá:

1. Criar sua conta de administrador.
2. Informar os dados solicitados.
3. Responder às perguntas iniciais da plataforma.

Depois disso, você terá acesso ao painel principal do N8N.

Pronto! Agora já pode começar a criar seus workflows e automatizar tarefas.

9. Monitorando o consumo de memória e CPU

Uma das vantagens do Dokploy é permitir acompanhar o consumo de recursos de cada aplicação.

Para acessar essas informações, entre no serviço do N8N e clique em:

Monitor

Nessa tela, você poderá acompanhar:

• Utilização da memória RAM.
• Consumo da CPU.
• Recursos utilizados individualmente por cada contêiner.

Também é possível selecionar um contêiner específico para analisar seu consumo.

Durante o tutorial, o contêiner principal do N8N estava utilizando aproximadamente 500 MB de memória.

Com essas informações, você consegue entender melhor o comportamento da aplicação e identificar quando será necessário aumentar os recursos da VPS.

O Dokploy também permite configurar limites de CPU e memória para os contêineres.

10. Configurando um domínio próprio

Neste momento, nossa instalação já está funcionando utilizando o domínio temporário disponibilizado pelo Dokploy.

Você pode utilizar esse endereço para acessar o N8N.

Entretanto, para uma instalação mais profissional, o ideal é configurar um domínio próprio.

Por exemplo:

n8n.seudominio.com.br

Assim, você terá um endereço personalizado para acessar sua plataforma de automação.

A configuração do domínio e do certificado SSL pode ser realizada posteriormente pelo próprio painel do Dokploy.

Conclusão

Como vimos, instalar o N8N com Dokploy é muito mais simples quando utilizamos templates prontos.

Com poucos cliques, conseguimos preparar toda a estrutura necessária para executar nossas automações, incluindo:

• N8N.
• PostgreSQL.
• Redis.
• Workers.

Também aprendemos a configurar o fuso horário, ajustar a quantidade de Workers, realizar o Deploy e monitorar o consumo de recursos da VPS.

O melhor de tudo é que não precisamos montar toda essa estrutura manualmente através do terminal.

Agora você já tem seu N8N instalado e pode começar a criar suas próprias automações!

Se quiser aprender mais sobre Docker, VPS e automações, continue acompanhando o Aprenda na Web.