Recupere o acesso ao n8n com a CLI

O comando user-management:reset retorna o gerenciamento de usuários do n8n ao estado anterior à configuração inicial. Ele remove todos os usuários da instância. Use esse procedimento para recuperar uma instalação própria quando você esqueceu a senha e não configurou SMTP para recuperação por e-mail.

Confira se o problema é a senha ou o MFA

Se a instância possui recuperação por e-mail configurada, use esse caminho antes de redefinir os usuários. O reset pela CLI tem alcance sobre toda a instalação, mesmo que apenas um login tenha sido perdido.

Para perda dos códigos de recuperação do MFA, a documentação apresenta outro comando. Ele desativa o MFA de um usuário específico:

1
docker exec -u node -it n8n-estudo n8n mfa:disable --email=seu-email@example.com

Substitua o e-mail pelo endereço real do usuário afetado. Depois de entrar novamente, configure o MFA outra vez. Esse comando atende à perda do segundo fator. Ele não substitui a recuperação de uma senha esquecida.

Faça uma cópia antes do reset

Para a instalação local com SQLite deste lote, pare o serviço e copie a pasta persistente para um destino novo no computador:

1
docker compose stop n8n
2
docker cp n8n-estudo:/home/node/.n8n ./backup-n8n-antes-do-reset
3
docker compose up -d

Execute na pasta do Compose. A cópia contém o SQLite e a configuração com a chave de criptografia nesse exemplo. Preserve também o Compose e as variáveis personalizadas. Em instalações com PostgreSQL, inclua também o backup desse banco.

Exportar somente workflows e credenciais não preserva usuários, histórico ou configurações. Para recuperar o estado anterior inteiro, o backup precisa incluir esses registros e a chave da instância.

Redefina o gerenciamento de usuários

Confira o nome real do container. Com a instância iniciada novamente, execute:

1
docker exec -u node -it n8n-estudo n8n user-management:reset

A CLI age diretamente sobre o banco e remove todos os usuários. O procedimento não escolhe um e-mail nem altera apenas uma senha. Por isso, os outros usuários também perdem seus logins anteriores.

Reinicie o serviço local com docker compose restart n8n. Abra o endereço da instância, conclua a configuração inicial do owner e confira se consegue entrar. Depois, examine os workflows e as credenciais disponíveis antes de retomar seus testes. Para apagar completamente a instância de estudo, use o procedimento de limpeza de volumes em vez de tratar esse reset como remoção geral.