Confira como atualizar o n8n via terminal SSH, especialmente se há um alerta no painel que informa sobre uma nova versão disponível.
A atualização do n8n varia conforme o tipo de instalação utilizada no servidor:
- Opção 1: n8n instalado pela HostGator
- Opção 2: n8n instalado manualmente por você, via Docker ou NPM
Opção 1: n8n instalado pela HostGator
Se você contratou a VPS HostGator com o adicional n8n, o ambiente já vem configurado com Docker e Docker Compose. Isso facilita o processo de atualização e mantém sua aplicação com todos os fluxos preservados.
Confira:
Processo de atualização
Siga estas etapas no SSH para atualizar o n8n:
1Acesse o SSH - Se necessário, confira como fazer
2No terminal, para acessar o diretório do n8n, digite o comando:
cd /opt/n8n-traefik/
3Para baixar a versão mais recente do n8n, digite o comando:
docker pull n8nio/n8n
Esse comando vai baixar a versão oficial mais atualizada do n8n para o seu servidor, substituindo a antiga:
- Se estiver atualizado, retornará o seguinte status:
- Se não estiver, fará a instalação da versão:
4Agora, atualize o docker digite o comando:
docker compose pull
Esse comando garante que todas as imagens definidas no arquivo do Docker Compose estejam na versão mais recente - Execute este passo independentemente de existir ou não uma nova versão
5Depois de ter a versão atualizada, remova os containers antigos, digite o comando:
docker compose down
Esse comando interrompe e remove os containers atuais, mas mantém os volumes e configurações intactos.
6Em seguida, para iniciar o Docker com a nova versão, digite o comando:
docker compose up -d
Isso inicia o n8n em segundo plano (modo “detached”) com a nova versão
Verificação pós-atualização
1Acesse o SSH - Se necessário, confira como fazer
2No terminal, verifique o status dos containers, para isso no terminal, digite:
docker compose ps
3Para verificar os logs para identificar possíveis problemas, digite:
docker compose logs -f n8n
4Para confirmar a versão atualizada, digite o comando:
docker exec -it nome-do-container-n8n n8n --version
Substitua "nome-do-container-n8n" pelo nome do container listado em "docker ps"
5Após alguns segundos, acesse seu painel n8n - Se necessário, confira como fazer
6Em seguida, teste seus fluxos de trabalho (workflows) principais, para garantir que tudo está funcionando corretamente
Pronto! Seu n8n está atualizado com a versão mais recente.
Opção 2: n8n instalado manualmente por você, via Docker ou NPM
Se você instalou o n8n por conta própria, o processo de atualização varia conforme o método utilizado:
- Via Docker + Docker Compose - Se você instalou o n8n desta forma o processo é o mesmo que o da instalação automática
- Via NPM (Node.js)
Via NPM (Node.js)
Se você fez a instalação por este método, confira como atualizar o n8n:
1Acesse o SSH - Se necessário, confira como fazer
2No terminal, atualize o pacote n8n com o comando:
npm install -g n8n
3Em seguida, verifique a versão instalada:
n8n --version
4Reinicie o serviço n8n para aplicar a atualização:
Se usa systemd
sudo systemctl restart n8n
Se usa PM2
pm2 restart n8n
Se executa manualmente, pare o processo atual (Ctrl+C) e execute:
n8n start
Pronto! Seu n8n está atualizado com a versão mais recente.