Change Root Email
Change the root email from the server terminal when the address is incorrect, inaccessible, or cannot receive Coolify's verification email.
Coolify Cloud users cannot access the container that runs this command. To change a Coolify Cloud account email when you cannot use the dashboard, contact the Coolify team.
Choose the right method
If you are signed in and your self-hosted instance can send transactional email, use the dashboard:
- Open Profile > General.
- Select Change Email.
- Enter the new address and select Send Verification Code.
- Enter the six-digit code sent to the new address, then select Verify & Update Email.
Use the terminal procedure below when you cannot sign in, cannot access the current address, or have not configured transactional email. The terminal command changes the login email immediately and does not send a verification message.
Before you change the email
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 password, or a plan to reset the root password after changing the email
- a correctly spelled email address that is not used by another account on the same Coolify instance
The command does not check the email format or whether the mailbox can receive messages. Coolify saves the address in lowercase, and the instance database rejects an address already used by another Coolify account. Check the complete address before submitting it.
Change the root email
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 email-change command
docker exec -it coolify php artisan root:change-emailCoolify displays this interactive prompt:
You are about to change the root user's email.
Give me a new email for root user:Enter the complete new email address. When Coolify saves it, the command prints:
Updating root email...
Root user's email updated successfully.The command updates only the root account's active login email. The current password, 2FA configuration, browser sessions, and API tokens remain unchanged. Coolify does not restart, and deployed applications, databases, and services continue running.
Verify the new login email
Keep the current dashboard session open, if one is available. Open the Coolify login page in a private browser window and sign in with:
- the new email address
- the existing root password
- the root account's two-factor authentication code, if 2FA is enabled
You should be able to sign in to the root account with the new email address. You should no longer be able to sign in with the email address used before the command.