Use a CLI do n8n dentro do container

A imagem Docker do n8n já inclui a Server CLI. Você executa os comandos dentro do container da instância, com acesso direto ao banco usado por ela. Para administrar essa instalação, abra o terminal do computador e use docker exec.

Identifique o container

Execute:

1
docker ps

Procure a imagem do n8n e confira a coluna NAMES. Os exemplos deste lote usam n8n-estudo, definido no guia de Compose local. Se sua instalação tiver outro nome, substitua esse trecho em cada comando. O nome do serviço no Compose e o nome do container podem ser diferentes.

O comando docker exec exige um container em execução. Se a instância estiver parada, inicie o serviço pelo Compose antes de seguir os exemplos. A possibilidade de alguns comandos administrativos funcionarem sem o servidor n8n não altera essa exigência do Docker.

Execute com o usuário node

A documentação orienta este formato para Docker:

1
docker exec -u node -it n8n-estudo n8n export:workflow --all --output=/home/node/workflows-cli.json

O Docker abre o processo dentro do container. A opção -u node escolhe o usuário da imagem. O trecho iniciado por n8n é o comando da Server CLI. Neste exemplo, ele exporta todos os workflows para um arquivo JSON.

Você digita a linha no terminal do computador, mas o caminho depois de --output pertence ao container. Procurar esse arquivo diretamente na pasta do projeto no computador não mostra o resultado.

Retire o arquivo do container

Copie o JSON para o diretório atual do computador:

1
docker cp n8n-estudo:/home/node/workflows-cli.json ./workflows-cli.json

Confira o conteúdo antes de recriar o container. A pasta /home/node usada nesse exemplo fica fora do volume persistente /home/node/.n8n. Arquivos exportados ali precisam ser copiados para fora para permanecerem disponíveis após a recriação.

Acesso administrativo direto

A Server CLI acessa o banco diretamente e pode executar tarefas administrativas que dispensam o login pelo editor. Proteja o acesso ao Docker como acesso à instância. Os comandos deste lote usam a Server CLI local, não exigem chave de API e não correspondem à CLI remota apresentada em outra seção da documentação do n8n.

Depois dessa primeira exportação, siga o guia específico para importar workflows, exportar credenciais ou recuperar o acesso. Cada comando tem efeitos próprios sobre a instância.