Setup Email
OpenPanel Enterprise supports Emails. Once enabled, a shared Email server becomes available for all users.
Follow these steps to enable Emails in OpenPanel:
1. Activate the Enterprise License​
Ensure that you're running the Enterprise Edition of OpenPanel. Email support is only available in this version.
Upgrading to OpenPanel Enterprise and activating License
2. Enable the Email Module​
OpenPanel uses a modular system where features can be individually enabled or disabled.
To enable the Email module:
- Go to OpenAdmin > Settings > Modules
- Find the Emails module and click Activate
3. Install the Email Service​
The Email feature uses the docker-mailserver stack.
To start it:
- Navigate to OpenAdmin > Emails > Email Accounts
- Copy the command displayed on the page
opencli email-server install - Paste it on Terminal and wait for the process to finish.
4. Enable the Emails Feature in Hosting Plans​
Emails access must be explicitly enabled in the hosting plan's feature set.
To do this:
- Go to OpenAdmin > Hosting Plans > Feature Manager
- Select the feature set you want to modify
- Enable the emails feature
5. Restart OpenPanel​
Restarting OpenPanel ensures that the newly enabled module and feature sets take effect immediately for all users.
To restart:
- Go to OpenAdmin > Services > Status
- Click Restart next to OpenPanel
Done​
Email is now enabled for all hosting plans that include the emails feature. Affected users can access Webmail an Email accounts form access it under OpenPanel > Emails.
Troubleshooting​
If the mail server fails to start, try launching it manually from the terminal:
cd /usr/local/mail/openmail && docker compose up mailserver
Review the startup logs for any errors, resolve them, and once the service is running correctly, stop it and restart it in detached mode using the -d flag.
The most common reasons the mail server fails to start include:
Another service already using port 25—for example, Exim. Solution: Disable or stop the conflicting service.
Firewall or iptables error that block docker starting. Solution: Restart the Docker service to reset network rules.
Invalid Configuration for mailserver. Solution: Revert the default mailserver .env file.