n8n na VPS: primeiro acesso, troca de senha e primeiros passos

O n8n é uma ferramenta de automação. Com ele você monta fluxos, que no n8n se chamam workflows, ligando aplicativos e serviços entre si: planilhas, e-mail, WhatsApp, CRMs, APIs e muito mais. Na sua VPS ele já vem instalado, com banco de dados próprio e HTTPS.

O que vale para todos os aplicativos (SSH, log, reiniciar) está no artigo Sua VPS com aplicativo: dados de acesso, onde fica cada coisa, ver o log, reiniciar o app.

Primeiro acesso

1. Abra o endereço que veio no e-mail: https://n8n.SEU-IP.yhostbr.online (o IP da VPS com traços no lugar dos pontos).
2. Entre com o e-mail do seu cadastro na yHost e a senha que veio no e-mail.
3. A conta de dono (owner) já foi criada na instalação. Por isso não aparece nenhuma tela de configuração inicial: você entra direto.

A tela do n8n é em inglês. Neste artigo, os nomes de menus e botões estão escritos como aparecem na tela.

Trocar a senha

1. Clique nos três pontinhos ao lado do seu nome, no canto inferior esquerdo da tela, e depois em Settings.
2. No menu de configurações, clique em Personal.
3. Na parte Security, clique em Change password.
4. Preencha Current password (a senha atual), New password (a nova) e Re-enter new password (a nova de novo).
5. Clique em Change password. Aparece a mensagem "Password updated".

A senha nova precisa ter pelo menos 8 caracteres, com pelo menos um número e uma letra maiúscula.

Primeiros passos

Criar o primeiro workflow

1. Na tela inicial (Overview), clique em Create workflow. Se aparecer o cartão Build a workflow, clique nele.
2. Clique em Add first step e escolha o gatilho, que é o que faz o workflow começar: um horário, um webhook, um formulário ou um aplicativo.
3. Adicione os próximos passos pelo botão + que aparece ao lado de cada nó.
4. Clique em Execute workflow para testar. Para testar um nó sozinho, abra o nó e clique em Execute step.

As mudanças são salvas sozinhas enquanto você edita, normalmente em poucos segundos.

Conectar suas contas (credenciais)

Para o n8n entrar nas suas contas (Google, e-mail, CRM e outras), cadastre uma credencial: na tela inicial, abra a aba Credentials e clique em Create credential. Também dá para criar a credencial direto dentro do nó, no campo de credencial dele. As credenciais ficam guardadas criptografadas no banco de dados da sua VPS.

Publicar o workflow

No n8n 2, um workflow só roda sozinho (por horário, por webhook ou por gatilho de aplicativo) depois de publicado. Quando ele estiver pronto, clique em Publish no topo do editor e confirme. Para tirar do ar, clique na setinha ao lado do botão Publish e escolha Unpublish.

Receber dados por webhook

O nó Webhook cria um endereço para outros sistemas chamarem o seu workflow. Ele mostra dois endereços:

• Test URL: para testar. Clique em Listen for test event e chame o endereço: os dados aparecem na tela do n8n.
• Production URL: o endereço de uso real. Só funciona com o workflow publicado, e os dados não aparecem na tela do workflow (veja na aba Executions).

Os endereços já saem com o seu domínio, no formato https://n8n.SEU-IP.yhostbr.online/webhook/... (o de teste usa /webhook-test/). O nó Webhook começa com HTTP Method em GET. Se o outro sistema envia os dados por POST, troque para POST.

Histórico e horário

O histórico de execuções (aba Executions) guarda os últimos 14 dias, até 10 mil execuções. As mais antigas são apagadas sozinhas, para o banco de dados não crescer sem parar. Os horários dos agendamentos seguem o horário de Brasília.

Onde o n8n roda na VPS

Problemas comuns

A página não abre logo depois da criação

A instalação leva de 2 a 6 minutos depois que a VPS liga. Na primeira vez, o n8n ainda prepara o banco de dados, o que leva cerca de 1 minuto. Espere uns 10 minutos e tente de novo numa janela anônima. Para acompanhar, veja o log da instalação: tail -n 30 /var/log/yhost-app.log.

O navegador avisa que a conexão não é segura

O certificado HTTPS ainda não saiu. Ele costuma sair poucos minutos depois da instalação e, se o endereço da VPS demorou a ficar pronto, o sistema tenta de novo sozinho a cada 10 minutos. Espere e recarregue a página. Enquanto o aviso aparecer, não digite sua senha. Se o aviso continuar depois de 1 hora, abra um chamado.

O workflow não roda sozinho

Confira se ele está publicado (botão Publish no topo do editor). Workflow sem publicar não roda por horário, por webhook de produção nem por gatilho de aplicativo.

O webhook funciona no teste, mas não no uso real

A Test URL só recebe chamadas enquanto o editor está esperando, depois que você clica em Listen for test event. No uso real, o outro sistema precisa chamar a Production URL, com o workflow publicado. Confira também se o HTTP Method do nó é o mesmo que o outro sistema usa (GET ou POST).

Chamei a Production URL e não apareceu nada na tela

É o normal: pela Production URL, o n8n não mostra os dados na tela do workflow. Veja o resultado na aba Executions.

Esqueci a senha

Se você ainda não trocou a senha, a original está na VPS, no arquivo /root/yhost-app.txt (use cat /root/yhost-app.txt). A recuperação de senha por e-mail do n8n não funciona, porque o envio de e-mail não vem configurado. Se você já trocou a senha e esqueceu, abra um chamado.

O n8n ficou lento ou parou

O n8n precisa de pelo menos 2 GB de memória, e 4 GB é o recomendado para uso mais pesado. Veja se o container está rodando com cd /opt/yhost/n8n e docker compose ps, e reinicie com docker compose restart. Se acontecer com frequência, fale com o suporte sobre um plano com mais memória.

Precisa de ajuda?

Abra um chamado em https://yhost.com.br/painel/suporte. Informe o IP da VPS e o que aconteceu. Se tiver uma mensagem de erro, mande um print.