n8n por CLI: importación/exportación, restablecimiento de usuario

Quien aloja n8n por sí mismo llega tarde o temprano al punto en que hay que respaldar workflows, transferirlos a otra instancia o restablecer una cuenta de usuario bloqueada. Para estas tres tareas, n8n ofrece sus propios comandos CLI, que se ejecutan directamente en el servidor y funcionan sin una interfaz web operativa. Este artículo muestra los comandos más importantes para exportar, importar y el restablecimiento de emergencia de contraseña, tal como se describen en la documentación oficial de n8n. Estado: julio de 2026.

Exportar workflows por CLI

El comando export:workflow exporta workflows de la base de datos de n8n a archivos JSON. Sin indicaciones adicionales se refiere a workflows individuales, pero con los indicadores adecuados la exportación puede ampliarse a todo el conjunto o prepararse directamente para una copia de seguridad.

• --all: Exporta todos los workflows de la instancia en lugar de uno solo.
• --id=<ID>: Exporta solo el workflow con el ID indicado.
• --output o -o: Define el archivo de destino o, para varios workflows, el directorio de destino.
• --backup: Activa automáticamente --all, --pretty y --separate para una copia de seguridad completa y legible.
• --separate: Escribe cada workflow como archivo propio, requiere un directorio junto con --output.
• --pretty: Formatea la salida JSON de forma legible en lugar de compacta.
• --published: Exporta la versión publicada de un workflow en lugar del borrador actual.
• --version=<VERSION_ID>: Exporta una versión histórica concreta de un workflow.

Para copias de seguridad periódicas resulta especialmente adecuada la combinación export:workflow --backup --output=backups/latest/, que se puede planificar bien como tarea diaria o semanal en un cronjob.

Importar workflows por CLI

La contraparte es import:workflow. Lee archivos JSON exportados previamente y los escribe de nuevo en la base de datos de la instancia de destino, por ejemplo en una migración de servidor o una recuperación tras una caída.

• --input: Ruta al archivo de entrada o, junto con --separate, a un directorio con varios archivos.
• --separate: Importa todos los archivos JSON de un directorio en lugar de un solo archivo.
• --projectId: Asigna los workflows importados a un proyecto concreto.
• --userId: Asigna los workflows importados a un usuario concreto.
• --activeState: Controla si los workflows importados se activan, false por defecto, o fromJson en funcionamiento multi-main.
• --skipMigrationChecks: Omite las comprobaciones de validación durante la importación.

Importante: los workflows con un ID que ya existe en la base de datos de destino se sobrescriben durante la importación, no se duplican. Por eso, antes de una importación en una instancia productiva, siempre merece la pena exportar previamente los workflows existentes como copia de seguridad.

Emergencia: restablecimiento de contraseña por CLI en caso de bloqueo

Si falta el acceso a una cuenta de n8n porque se olvidó una contraseña y no hay ningún servidor SMTP configurado para el restablecimiento habitual por correo electrónico, según la documentación de n8n ayuda el comando user-management:reset. Vuelve a poner la gestión de usuarios en el estado anterior a la configuración inicial y elimina de paso todas las cuentas de usuario existentes. La próxima vez que se acceda a la interfaz web, n8n vuelve a pedir la configuración de una nueva cuenta de propietario, de forma similar a una instalación nueva.

El comando es deliberadamente radical: elimina todas las cuentas de usuario de la instancia, no solo la afectada. Los roles, permisos y asignaciones a proyectos deben volver a establecerse después. Según la documentación, los workflows, las credenciales y el historial de ejecución no se ven afectados por ello, ya que el comando solo restablece la gestión de usuarios.

Para el caso más restringido de que alguien ya no pueda usar la autenticación de dos factores, por ejemplo porque se han perdido los códigos de recuperación, basta con el comando menos drástico mfa:disable --email=<direccion-de-correo>. Desactiva la MFA exactamente para esa cuenta, de modo que la persona pueda volver a iniciar sesión con normalidad y configurar de nuevo la autenticación de dos factores.

Otros comandos CLI para el día a día

• export:credentials e import:credentials: Respaldan y transfieren credenciales; con --decrypted todos los valores sensibles quedan en texto plano en el archivo, lo que debe manejarse con la precaución correspondiente.
• audit: Comprueba la instancia en busca de problemas de seguridad comunes.
• license:info y license:clear: Muestran la licencia actual o la restablecen al conjunto de funciones predeterminado.
• n8n --help: Lista todos los comandos disponibles de la versión de n8n instalada, ya que el conjunto de funciones puede variar según la versión.

Los comandos CLI se ejecutan directamente en el servidor y requieren el acceso correspondiente, por ejemplo por SSH o docker exec. Quien opera n8n con un proveedor sin acceso a shell generalmente no puede usarlos y depende del soporte del proveedor. Para las empresas que alojan n8n por sí mismas y dependen en el día a día de copias de seguridad fiables y un plan de emergencia documentado, NordFlux apoya en la implantación y operación de n8n con una configuración en la que usted mismo mantiene el control sobre los datos y los accesos.

Preguntas frecuentes sobre la importación/exportación por CLI de n8n

¿Cómo respaldo automáticamente todos los workflows de n8n?

Con el comando export:workflow --backup --output=<directorio> se pueden respaldar todos los workflows en forma legible y separada. El comando es adecuado como tarea cron diaria en el servidor, complementada con una copia del directorio de destino a una segunda ubicación de almacenamiento.

¿Se eliminan también los workflows y las credenciales con user-management:reset?

No. Según la documentación de n8n, el comando restablece exclusivamente la gestión de usuarios y elimina todas las cuentas de usuario. Los workflows, las credenciales y el historial de ejecución se conservan, pero deben reasignarse a una nueva cuenta de propietario después del restablecimiento.

¿Puedo exportar workflows individuales en lugar de toda la instancia?

Sí. Con export:workflow --id=<ID> --output=archivo.json se puede exportar de forma específica un solo workflow, sin tocar el resto del conjunto.

¿Qué ocurre si un ID de workflow importado ya existe?

El workflow existente con el mismo ID se sobrescribe durante la importación, no se crea como copia. Por eso se recomienda realizar una exportación actual como respaldo antes de cada importación en una instancia en funcionamiento, véase la documentación de n8n sobre la línea de comandos y la documentación sobre la gestión de usuarios.