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.