n8n é um editor visual líder para iterações rápidas, que permite criar workflows de automação e ver resultados imediatamente. Perfeito para automações do dia a dia e workflows complexos com agentes de IA.
O suporte para self-hosting e o editor low-code fazem do n8n o favorito de qualquer desenvolvedor. Se você quer controle máximo, personalizações individuais e economizar custos a longo prazo, a versão self-hosted é ideal para você.
Quer hospedar o n8n por conta própria? Vamos guiá-lo passo a passo na instalação e configuração, mostrando tudo o que você precisa saber.
Você pode instalar o n8n diretamente pelos Aplicativos com um clique na interface web do VPS. Após configurar o primeiro app, abra o catálogo de apps, procure por n8n e inicie a instalação com suas preferências de projeto, ambiente e domínio. Assim, você pode implantar e gerenciar o n8n rápida e facilmente – sem precisar usar linha de comando manualmente – e ainda aproveitar o gerenciamento web integrado, suporte a domínios personalizados e certificados SSL, quando disponíveis.
O n8n pode ser usado em muitos cenários do dia a dia e é ideal para quem quer automatizar tarefas, usar editor low-code, criar agentes de IA, controlar automações, impulsionar CRM, otimizar operações de TI e segurança, prototipar backends e muito mais! O n8n é perfeito para iniciantes e profissionais.
O n8n oferece mais de 1367 integrações como Google Sheets, Telegram, MySQL, Slack, Discord, Postgres e combinações legais de automações como HubSpot & Salesforce, Twilio & WhatsApp, GitHub & Jira, Asana & Slack, Asana & Salesforce, Jira & Slack e muitos templates da comunidade.
Embora o n8n seja leve, o consumo de recursos pode aumentar conforme o número de workflows, chamadas de API e nodes que processam muitos dados. Recomendamos o seguinte hardware para seu VPS para hospedar o n8n:
| Hardware | Mínimo | Recomendado |
|---|---|---|
| CPU | 1 núcleo vCPU | 2 núcleos vCPU |
| RAM | 2 GB | 4 GB |
| Armazenamento | 20 GB | 50 GB |
Antes de começar, é necessário atualizar o Docker e os pacotes do sistema. Já temos um guia para instalar o Docker. É melhor fazer isso primeiro.
Depois que o Docker estiver rodando no seu servidor, verifique a instalação com:
docker --version
docker compose version
Crie um diretório de projeto para armazenar arquivos locais e variáveis de ambiente do n8n, e entre nele:
mkdir n8n-compose
cd n8n-compose
No diretório n8n-compose, crie um arquivo .env com nano .env e insira o seguinte código com as variáveis de ambiente do n8n:
# DOMAIN_NAME e SUBDOMAIN definem o endereço onde o n8n estará acessível
# O domínio de topo
DOMAIN_NAME=zap.cloud
# A subdomínio
SUBDOMAIN=silver-octopus-xxxxx
# O exemplo acima torna o n8n acessível em: https://silver-octopus-xxxxx.zap.cloud
# Fuso horário opcional usado por Cron e outros nodes de agendamento
GENERIC_TIMEZONE=Europe/Berlin
# E-mail para criação do certificado TLS/SSL
SSL_EMAIL=hello@zap-hosting.com
Hostname.
Digite a parte zap.cloud em DOMAIN_NAME e a primeira parte em SUBDOMAIN (ex: silver-octopus-xxxxx).
Requisito HTTPS Não use um endereço IP puro no arquivo .env. O n8n requer conexão HTTPS, e certificados SSL são emitidos apenas para domínios, não para IPs.
Se preferir hospedar o n8n em seu próprio domínio, crie uma subdomínio para o n8n adicionando um registro A no gerenciador DNS do seu domínio apontando para o IP do seu VPS.
| Nome | Tipo | Valor | TTL | Prioridade |
|---|---|---|---|---|
| n8n (subdomínio) | A | Endereço IPv4 | 1440 | 0 |
No diretório do projeto, crie uma pasta chamada local-files para compartilhar arquivos entre a instância do n8n e o sistema host:
mkdir local-files
Crie o arquivo Docker Compose compose.yaml com nano compose.yaml e insira o conteúdo abaixo:
services:
traefik:
image: "traefik"
restart: always
command:
- "--api.insecure=true"
- "--providers.docker=true"
- "--providers.docker.exposedbydefault=false"
- "--entrypoints.web.address=:80"
- "--entrypoints.web.http.redirections.entryPoint.to=websecure"
- "--entrypoints.web.http.redirections.entrypoint.scheme=https"
- "--entrypoints.websecure.address=:443"
- "--certificatesresolvers.mytlschallenge.acme.tlschallenge=true"
- "--certificatesresolvers.mytlschallenge.acme.email=${SSL_EMAIL}"
- "--certificatesresolvers.mytlschallenge.acme.storage=/letsencrypt/acme.json"
ports:
- "80:80"
- "443:443"
volumes:
- traefik_data:/letsencrypt
- /var/run/docker.sock:/var/run/docker.sock:ro
n8n:
image: docker.n8n.io/n8nio/n8n
restart: always
ports:
- "127.0.0.1:5678:5678"
labels:
- traefik.enable=true
- traefik.http.routers.n8n.rule=Host(`${SUBDOMAIN}.${DOMAIN_NAME}`)
- traefik.http.routers.n8n.tls=true
- traefik.http.routers.n8n.entrypoints=web,websecure
- traefik.http.routers.n8n.tls.certresolver=mytlschallenge
- traefik.http.middlewares.n8n.headers.SSLRedirect=true
- traefik.http.middlewares.n8n.headers.STSSeconds=315360000
- traefik.http.middlewares.n8n.headers.browserXSSFilter=true
- traefik.http.middlewares.n8n.headers.contentTypeNosniff=true
- traefik.http.middlewares.n8n.headers.forceSTSHeader=true
- traefik.http.middlewares.n8n.headers.SSLHost=${DOMAIN_NAME}
- traefik.http.middlewares.n8n.headers.STSIncludeSubdomains=true
- traefik.http.middlewares.n8n.headers.STSPreload=true
- traefik.http.routers.n8n.middlewares=n8n@docker
environment:
- N8N_ENFORCE_SETTINGS_FILE_PERMISSIONS=true
- N8N_HOST=${SUBDOMAIN}.${DOMAIN_NAME}
- N8N_PORT=5678
- N8N_PROTOCOL=https
- N8N_RUNNERS_ENABLED=true
- NODE_ENV=production
- WEBHOOK_URL=https://${SUBDOMAIN}.${DOMAIN_NAME}/
- GENERIC_TIMEZONE=${GENERIC_TIMEZONE}
- TZ=${GENERIC_TIMEZONE}
volumes:
- n8n_data:/home/node/.n8n
- ./local-files:/files
volumes:
n8n_data:
traefik_data:
Isso instalará o n8n, emitirá um certificado SSL, configurará e ativará o n8n no domínio.
Inicie o n8n com:
sudo docker compose up -d
Para parar o n8n, use:
sudo docker compose stop
Após iniciar, abra o n8n no navegador pelo URL (ou hostname, se você usou). Você precisará criar uma conta de administrador primeiro.
Lembre da senha Guarde bem sua senha para uso futuro!
Depois, aparecerá uma pequena pesquisa para você preencher algumas informações básicas.
Opcionalmente, você pode obter acesso gratuito a alguns recursos pagos inserindo seu e-mail e recebendo uma chave de licença por e-mail. Se estiver interessado, digite seu e-mail e solicite a chave.
A chave de licença chega imediatamente por e-mail. Copie e cole em Configurações > Uso & Planos > Inserir chave de ativação.
Depois disso, você pode ir direto ao dashboard e começar a usar o n8n!
Comece com uma tela em branco ou use um template pronto. Sua instalação do n8n está pronta!
Parabéns! Você instalou o n8n com sucesso no seu servidor e já pode começar a usar. Também recomendamos conferir estes recursos que podem ajudar na configuração do servidor:
- n8n.io – Site oficial
- docs.n8n.io – Documentação do n8n
Tem dúvidas específicas que não foram respondidas aqui? Para mais ajuda ou suporte, nossa equipe está disponível diariamente – estamos aqui para você! 🙂