Let’s be real, forgetting a password suddenly has happened to all of us or losing that posted note you had on your desk. As Uptime Kuma also requires login information in order to let you sign in. Resetting your password in Uptime Kuma can be achieved using different methods in case you ever forget it. This goes the same for 2FA security, that can also be removed.
The most popular method is that you exec into the Uptime Kuma Docker container and run a simple one-liner command. The other method is a bit more technical where you will have to Install SQLite and edit the database.
Remember: The default login password of Uptime Kuma is “Password”, have you tried that? You can learn more about such common questions in our FAQ.
Contents
Requirements
- Uptime Kuma Installed using Docker or Docker Compose
- Access to your server via SSH or terminal if hosted locally
Reset Forgotten Uptime Kuma Login Password from CLI
This method works for those who have Uptime Kuma Installed in a Docker container environment. It requires you to exec into the container and run a simple command to reset your password.
Just a side note: To exec into a Docker container is the same as how you would SSH onto a Linux server. You can read more about it here.
Step 1: SSH onto your server where Uptime Kuma is installed:
ssh your-user@your-server-ipNow run the following command with a root user or a user with sudo permissions, and replace <enter container name here> with your own container name which you can get by running the “docker ps” command:
docker exec -it <enter container name here> bash
Once you exec into the container, run the following command it will ask you to provide a new password:
npm run reset-passwordIf you have Uptime Kuma Installed directly on your Linux or Windows server, please change to the directory where Uptime Kuma is located on your server and run the following command:
npm run reset-passwordReset or Remove your 2FA/MFA from Uptime Kuma
2FA and MFA enhance the security of your login. This is an Uptime Kuma feature that provides added security to your monitoring dashboard. The first part of the process is the same as the above method where you have to exec into the container:
docker exec -it <enter container name here> bash
Once you are inside the container, running the following command will completely remove 2FA from your configuration.
npm run remove-2fa