How to configure SMTP relay for outgoing emails
In BeAdmin, you can connect an external SMTP server (such as Gmail) to enable the panel to send system emails — such as password reset links, Xray client configurations, and other notifications. This improves deliverability and reduces the risk of messages being marked as spam.
To configure SMTP relay, follow these steps:
Step 1. Enter SMTP Server Details
Go to Settings → System and provide the details of the mail server you want to use. Make sure to enable the "Server enabled" toggle — it takes effect immediately, without the "Save" button.
Enter the following values:
- "Server address": e.g.
smtp.gmail.comfor Gmail - "Server port":
587(STARTTLS) or465(SMTPS) - "Username": your email address, e.g.
you@gmail.com - "Password": for Gmail, generate an app-specific password
After filling in the fields, click "Save".
💡 Tip
You can find SMTP settings for other popular providers (such as Outlook, Zoho Mail, iCloud Mail, Fastmail, etc.) in their official support documentation.
Step 2. Test Email Sending
After that:
BeAdminwill automatically use the configured SMTP relay for all outgoing messages — such as system notifications.- To verify that the relay works, click "Test SMTP" below the form fields. If the button is inactive, make sure the "Server enabled" toggle is on and the settings are saved.
- In the "Send test email" dialog, enter your email address in the "Email" field and click "Send". The email will be sent using the saved SMTP settings.
- Check your inbox. If the email arrived, your SMTP settings are correct; it may have landed in spam. If the panel reports that the email was not sent, check the SMTP settings or change them and test again.
⚠️ Warning
If you disable the SMTP relay, outgoing email will no longer work.
Password Recovery by Email
Once the SMTP relay is configured, users can recover their password right from the login page: the panel sends emails with a reset link. This is turned off by default — in that case a password can only be recovered from the server console, as described in Recovering a user's password via SSH. Only the panel owner can turn on recovery by email.
⚠️ Better left off on production servers
If the login page is reachable from the internet, any visitor can see the "Reset password" link and trigger reset emails. They cannot change anyone's password this way — that takes access to the user's mailbox — so the option itself is safe. But users will start receiving emails they never asked for. On production servers, it is best to keep recovery by email turned off: a password can be recovered from the server console. Turn it on for test servers and wherever a firewall keeps outsiders away from the login page.
To turn on recovery by email:
- Configure the SMTP relay using the steps above: the "Server enabled" toggle must be on. Until SMTP is configured, the recovery toggle is inactive.
- Go to Settings → System and find the "Password recovery" section. Other panel users do not see it.
- Turn on the toggle: its label changes from "SSH only" to "Email and SSH". The toggle takes effect immediately, without the "Save" button.
- Check the "Panel address" field below the toggle: without it, the link will not appear on the login page.
From there, it works like this:
- The "Reset password" link appears on the login page. The user clicks it, enters their email address, and clicks "Send".
- The panel sends an email with a link to confirm the reset to that address.
- The user opens the link from the email: it leads to the panel's login page, and the panel sends a second email with a temporary password.
- The user signs in with the temporary password and sets a permanent password in the profile right away. For details, see How the temporary password works.
A few more things to know:
- The link in the email leads to the address from the "Panel address" field. Enter just a domain or an IP address, for example
panel.example.comor203.0.113.10: the panel adds the scheme (https://) and the port itself. While the field is empty, the "Reset password" link is not shown on the login page. - The field fills in by itself: when the owner signs in with a password, the panel saves the address used to open it. If the emails should lead somewhere else — for example, to a domain instead of an IP address — enter it manually.
- The link in the email is only valid for a short time: if it has expired, request the email again.
- If you turn off the SMTP relay (the "Server enabled" toggle) or clear the "Server address", recovery by email turns off on its own. After you configure SMTP again, turn it back on.
- You can turn recovery off at any time: the "Reset password" link disappears from the login page, emails stop being sent, and the links from emails already sent stop working.
Setup Complete
Your BeAdmin server is now using an external SMTP relay for sending emails. This ensures reliable delivery and allows the panel to send technical notifications as intended.
You can change or disable the SMTP settings at any time via Settings → System.