Skip to main content

Reset the Owner Password

If you run a self-hosted kuploy instance and have lost the owner account's password, reset it from inside the running container. There is no email-based "forgot password" flow for the owner on a self-hosted instance: that flow needs working SMTP, and the owner is the account you would use to configure it.

On Kuploy Cloud

This page is for self-hosted instances. On Kuploy Cloud the login page shows a Lost your password? link that emails you a reset link instead — you do not need shell access.

What the command does

reset-password finds the instance owner account, replaces its password with a freshly generated random one, and prints that password to stdout. It touches nothing else: no other user, no session, no data.

Sign in with the printed password and change it immediately from Settings → Profile.

Kubernetes

kubectl exec -it deployment/kuploy -n kuploy -- pnpm run reset-password

Docker

docker exec -it <container> pnpm run reset-password

Use docker ps to find the container name if you don't know it.

Local development

From the repository root:

pnpm run reset-password

Troubleshooting

"Error resetting password" — the command could not reach the database. Check that DATABASE_URL is set in the container's environment and that the database is reachable from it.

The printed password doesn't work — make sure you signed in as the owner account. The command only ever resets the owner; every other user keeps their own password and changes it from Settings → Profile.