Cómo recuperar la contraseña de n8n en entornos de desarrollo (paso a paso)

Si has perdido el acceso a tu instancia de n8n —especialmente en un entorno de desarrollo— saber cómo recuperar la contraseña de n8n es esencial para volver a trabajar sin perder tus workflows.

En este artículo te explico paso a paso cómo restaurar la contraseña de n8n, basándome en procesos reales y probados, para que puedas hacerlo de forma rápida y segura.

¿Por qué puede perderse la contraseña en n8n?

Perder la contraseña de n8n puede ocurrir por varias razones:

• Cambio de credenciales sin respaldo.
• Configuración inicial incompleta.
• Tiempo sin acceso y olvido de la contraseña.
• Problemas con la base de datos que almacenaba las credenciales.
• Estabas cacharreando y no esperabas seguir usando la herramienta

En entornos de desarrollo, especialmente al usar Docker o instalaciones locales, el sistema no cuenta con mecanismos de recuperación automáticos como los de apps SaaS; por eso es útil saber cómo recuperar la contraseña de n8n manualmente.

Lo mínimo que necesitamos para restaurar la contraseña

Antes de comenzar, asegúrate de tener:

• Acceso al servidor o máquina donde está instalado n8n.
• Permisos para usar Docker (si aplica).
• Terminal o consola con privilegios para ejecutar comandos.

Cómo recuperar y actualizar la contraseña de n8n paso a paso

El siguiente proceso restaura el usuario admin sin eliminar tus workflows ni datos existentes.

1. Abre tu terminal

Inicia tu línea de comandos en la máquina donde está corriendo tu instancia de n8n.

2. Identifica el contenedor de n8n

Si n8n corre usando Docker, necesitas identificar el contenedor:

docker ps

Este comando te mostrará los contenedores activos. Busca el que tiene n8n en la lista.

3. Ejecuta el comando de reset

Ahora, ejecuta el comando dentro del contenedor para resetear el usuario por defecto:

docker exec -it [nombre_del_contenedor] n8n user-management:reset

Esto restablecerá el usuario admin en la base de datos, permitiendo crear uno nuevo.

📌 Reemplaza [nombre_del_contenedor] por el nombre o ID real que viste con docker ps.

4. Reinicia el contenedor

Para que los cambios tengan efecto, reinicia el servicio:

docker restart [nombre_del_contenedor]

5. Accede y crea nuevas credenciales

Abre tu navegador en modo incógnito (o limpia la caché) y navega a tu instancia de n8n (por ejemplo http://localhost:5678).

El sistema te pedirá crear una nueva cuenta admin con:

• Nuevo correo
• Nueva contraseña

6. Verifica que tus workflows están intactos

Una vez dentro, revisa tus workflows y datos: no deberían haberse perdido durante el proceso.

Preguntas frecuentes (FAQ)

¿Este proceso elimina mis workflows?

No. El comando de reset solo afecta al usuario admin, no a tus workflows ni a las credenciales de integraciones.

¿Funciona si no uso Docker?

Sí, pero el comando variará según cómo instalaste n8n. En instalaciones locales puedes ejecutar:

n8n user-management:reset

O revisar la documentación específica de tu entorno.

¿Se puede hacer sin acceso SSH?

No. Necesitas acceso al servidor o sistema donde corre n8n para ejecutar los comandos de reset.

Conclusión (esto es para el SEO, puedes ignorarlo)

Saber cómo recuperar la contraseña de n8n en entornos de desarrollo te ahorra tiempo y posibles dolores de cabeza. Con unos simples pasos puedes restablecer el acceso sin perder tus workflows ni tus datos.

Si usas Docker, el proceso es especialmente rápido y seguro: identifica el contenedor, ejecuta el comando de reset y configura tus nuevas credenciales.