¿Olvidaste la contraseña de Uptime Kuma? Se arregla en un minuto

Uptime Kuma trae una herramienta para restablecer la contraseña. Cómo usarla en Docker, por qué pide una terminal «de verdad» y cómo hacer lo mismo en Portainer.

IvánPublicado el Actualizado el 10 de octubre de 20264 minRead in English

Me pasó hace poco: quería configurar los avisos de Uptime Kuma y no me acordaba de la contraseña. Es lo que tiene montar algo y no volver a entrar en semanas. Una semana después me pasó lo mismo con Portainer. Así que aquí van los dos.

Buena noticia: no hay que reinstalar nada ni perder los monitores. Uptime Kuma trae una herramienta para restablecerla.

Y si buscabas la contraseña por defecto: no hay. Uptime Kuma te pide crear el usuario administrador la primera vez que entras, así que si se te ha olvidado, restablecerla es la única forma de volver a entrar.

1. Uptime Kuma en Docker

Desde la máquina donde corre el contenedor:

docker exec -it uptime-kuma npm run reset-password
  • uptime-kuma es el nombre del contenedor. Si el tuyo se llama distinto, compruébalo con docker ps.
  • Te pedirá la contraseña nueva dos veces. Mientras escribes no se ve nada: es normal.
  • Cambia la contraseña del usuario que ya tenías. No crea uno nuevo.

Después, entra en la web con tu usuario de siempre y la contraseña nueva.

Si no lo tienes en Docker

Entra en la carpeta donde instalaste Uptime Kuma y lanza:

npm run reset-password

2. Si lo haces desde otro ordenador por SSH

Aquí está la trampa. Si lanzas el comando así:

ssh pi@192.168.1.50 docker exec -it uptime-kuma npm run reset-password

fallará con un error parecido a «the input device is not a TTY». La herramienta necesita una terminal interactiva para preguntarte la contraseña, y SSH, cuando le pasas un comando directamente, no abre una.

La solución es añadir -t a ssh:

ssh -t pi@192.168.1.50 docker exec -it uptime-kuma npm run reset-password

Y si te ayuda un asistente de IA

Yo gestiono buena parte de la Pi con un asistente de IA en la terminal, y aquí se atascó: su terminal no es interactiva, así que no puede escribir la contraseña cuando la herramienta la pide. Tiene sentido que sea así, además: la contraseña nueva la tienes que escribir tú, no pasársela a nadie.

Lo que hice fue lanzar yo el comando. Hay dos maneras:

  • Abrirlo en una terminal normal (en Windows, la app Terminal).
  • Si tu asistente lo permite, ejecutar el comando tú mismo desde su propia ventana. En Claude Code, por ejemplo, empiezas la línea con ! y el comando corre en tu terminal, con TTY.

3. Lo mismo, pero en Portainer

Portainer no tiene un reset-password dentro del contenedor, sino una imagen aparte que hace el trabajo. Tiene un detalle importante: para el contenedor antes, porque la herramienta abre los mismos datos que usa Portainer.

docker stop portainer
docker run --rm -v portainer_data:/data portainer/helper-reset-password
docker start portainer
  • portainer_data es el volumen donde Portainer guarda sus datos. Si lo creaste con otro nombre, míralo con docker inspect portainer (apartado Mounts).
  • A diferencia de Kuma, no te pregunta nada: genera una contraseña para el usuario administrador y la escribe en pantalla. Cópiala.
  • Entra con ella y cámbiala desde la propia web (tu usuario → cambiar contraseña), que esa generada no la vas a recordar.
  • --rm borra el contenedor de la herramienta al acabar. La imagen sigue descargada; si no la quieres guardar, docker rmi portainer/helper-reset-password.

¿Y si tampoco recuerdas el usuario?

Prueba primero con los típicos (admin, tu nombre). En Portainer, la herramienta restablece la del administrador original, así que no necesitas saberlo. En Kuma, el nombre de usuario está en su base de datos, pero ahí ya estás tocando datos delicados: haz una copia antes de abrirla (y si es SQLite, copia también los archivos -wal y -shm, como explico al actualizar Kuma de la 1 a la 2).

Lo que no hay que hacer

  • Borrar el contenedor y volver a crearlo pensando que así empiezas de cero. Los datos (y la contraseña) viven en el volumen, no en el contenedor, así que vuelves a estar donde estabas.
  • Borrar el volumen para empezar de cero. Eso sí funciona, pero pierdes todos los monitores, el historial y las notificaciones.
  • Lanzar la herramienta de Portainer con Portainer en marcha.
  • Pasarle la contraseña nueva a un asistente o pegarla en un chat. Escríbela tú.

Resumen

  1. Kuma: docker exec -it uptime-kuma npm run reset-password.
  2. Por SSH, añade -t. Desde un asistente de IA, lánzalo tú.
  3. Portainer: para el contenedor, lanza portainer/helper-reset-password contra su volumen y arráncalo.
  4. Cambia la contraseña generada nada más entrar.

Para que no vuelva a pasar

Guárdala en un gestor de contraseñas. Yo tengo uno montado en casa en la misma Raspberry Pi, y es donde van ahora todas las contraseñas de los servicios caseros. La contraseña que no tienes que recordar es la que no olvidas.

Mini-quiz

¿Te has quedado con la idea?

Tres preguntas rápidas. Cada acierto suma 10 XP.

  1. ¿Qué comando restablece la contraseña de Uptime Kuma en Docker?
  2. ¿Para qué sirve la opción -t de ssh en este caso?
  3. ¿Por qué hay que parar Portainer antes de lanzar helper-reset-password?
  • #uptime-kuma
  • #portainer
  • #docker
  • #ssh
  • #contrasenas
Esc