Reset Root Password
Reset the root password from the server terminal when you cannot sign in to the root account and cannot use an emailed password-reset link.
Coolify Cloud users cannot access the container that runs this command. If you cannot access your Coolify Cloud account, contact the Coolify team.
Choose the right recovery method
Use the least disruptive method available:
- If you are signed in and know the current password, open Profile > General, enter the current and new passwords under Change Password, then select Save.
- If you can receive transactional email from the instance, select Forgot Password on the login page and use the emailed reset link.
- If neither option is available, use the terminal procedure below. It does not require the current root password or a working email configuration.
Before you reset the password
Make sure you have:
- SSH access to the server that runs the self-hosted Coolify instance
- permission to run Docker commands on that server
- the root account's current login email, or a plan to change the root email after the reset
- a strong, unique password ready to enter twice
The terminal command checks only that both password entries match. It does not enforce the password rules used by the Coolify dashboard. Use a long, randomly generated password that you do not use for another account, and store it in a password manager.
After the password changes, Coolify signs the root account out on every device and revokes every API token owned by that account. Sessions and API tokens for other users are not affected.
Reset the root password
Connect to the Coolify server
Connect over SSH to the machine that runs the Coolify control plane:
ssh root@<server-ip>Replace <server-ip> with the server's IP address. If you connect as a non-root user, that account must have permission to run Docker commands. Add sudo before the Docker commands below when your server requires it.
Confirm that the Coolify container is running
docker inspect --format '{{.State.Status}}' coolifyThe command should print running. If Docker reports that the coolify container does not exist or is not running, update or repair the Coolify installation before continuing.
Run the password-reset command
docker exec -it coolify php artisan root:reset-passwordCoolify displays these interactive prompts:
You are about to reset the root password.
Give me a new password for root user:
Again:Type the new password at the first prompt, then type the same password again. The terminal does not display the password while you type.
When both entries match and the root account exists, Coolify prints:
Updating root password...
Root password updated successfully.The command updates only the root account password. It does not restart Coolify or interrupt deployed applications, databases, or services.
Verify root access
Open the Coolify login page in a private browser window and sign in with:
- the root account's current email
- the new password
- the root account's two-factor authentication code, if 2FA is enabled
Using a private window verifies a fresh login without relying on an existing browser session. Existing root sessions should no longer open the dashboard after the password change.
If an integration used an API token owned by the root account, create a replacement token after signing in and update that integration. The revoked token cannot be restored.