# WHMCS Email Solution Module - Installation and configuration

**This article provides step-by-step guidance on integrating the Openprovider Email Solution module with WHMCS.**

**For quick navigation, the following topics are covered:**

- Uploading the Openprovider Email Solution files
- Configuring the Openprovider Email Solution server module
- Creating a product group and product
- Linking the product with the server module

### 1. How to upload the Openprovider - email solution files?

1. Download the module file from [here](https://github.com/openprovider/Openprovider-WHMCS-Email-solution).
2. Extract the downloaded module file.
3. Inside your WHMCS installed directory, go to this path "**/modules/servers**" and upload the folder '**email\_solution**'.

<span>![embedded-image-7zzzpvwh.png](https://openprovider.help/uploads/images/gallery/2026-08/embedded-image-7zzzpvwh.png)</span>

### 2. How to configure the Openprovider - email solution server module?

1. Go to **Configuration** &gt;&gt; **System Settings** &gt;&gt; **Servers**.

<span>![embedded-image-1m67cbhb.png](https://openprovider.help/uploads/images/gallery/2026-08/embedded-image-1m67cbhb.png)</span>

<span>2. Click on **Add New Server** and then click the **Go to Advance Mode** button.</span>

<figure id="bkmrk--2">![embedded-image-tnzlyje0.png](https://openprovider.help/uploads/images/gallery/2026-08/embedded-image-tnzlyje0.png)</figure><span>![embedded-image-gfbajnby.png](https://openprovider.help/uploads/images/gallery/2026-08/embedded-image-gfbajnby.png)</span>

3\. <span>Fill in a name of your choice (eg: Email Solution), API hostname (**api.openprovider.eu**), and select module **Openprovider - email solution,** and fill your API username and password, and click the **Save Changes** button. Please ensure the user you are using has API access enabled. If not, please enable API access for the user following instructions in </span>[<span>this article</span>](https://openprovider.help/books/quick-start/page/how-to-enable-api-access)<span>.</span>

<figure id="bkmrk--3">![embedded-image-wsclnlpb.png](https://openprovider.help/uploads/images/gallery/2026-08/embedded-image-wsclnlpb.png)</figure><figure id="bkmrk--4">![embedded-image-kp9stnrr.png](https://openprovider.help/uploads/images/gallery/2026-08/embedded-image-kp9stnrr.png)</figure>4\. <span>After Save click on edit button then click **Test connection.**</span>

<figure id="bkmrk--5">![embedded-image-cxuii1do.png](https://openprovider.help/uploads/images/gallery/2026-08/embedded-image-cxuii1do.png)</figure><figure id="bkmrk--6">![embedded-image-80ysgvnv.png](https://openprovider.help/uploads/images/gallery/2026-08/embedded-image-80ysgvnv.png)</figure>5\. <span>Now, create a new server group. Click on **Create New Group.**</span>

<figure id="bkmrk--7">![embedded-image-9xdyxrtu.png](https://openprovider.help/uploads/images/gallery/2026-08/embedded-image-9xdyxrtu.png)</figure>6\. <span>On the new page:</span>

- In the **Name** field, enter the server group name.
- Select the desired server from the list.
- Click the **Add** button to include the selected server in the group.

<span>Once all required servers are added, click the **Save** button to create the server group</span>

<figure id="bkmrk--8">![embedded-image-b85ecyfc.png](https://openprovider.help/uploads/images/gallery/2026-08/embedded-image-b85ecyfc.png)</figure>### <span>3. How to create a product group and a product?</span>

1. <span>Go to **System Settings &gt;&gt; Find Product/Service** and click on it.</span>

<figure id="bkmrk--9">![embedded-image-dzxk0az0.png](https://openprovider.help/uploads/images/gallery/2026-08/embedded-image-dzxk0az0.png)</figure>2\. <span>You will now be on the Products page. Click on the **Create a New Group** button. Enter the Product Group Name. You can also add a headline and tagline, select the Order Form and Payment Gateway, or choose to set the group as hidden. Once you've entered all the details, click **Save Changes**.</span>

![embedded-image-eha08ffb.png](https://openprovider.help/uploads/images/gallery/2026-08/embedded-image-eha08ffb.png)

![embedded-image-0du3wrnp.png](https://openprovider.help/uploads/images/gallery/2026-08/embedded-image-0du3wrnp.png)

3\. <span>Your product group has been created. Now, click on the **Back to Product List** button. You will see the newly created product group on the Products page. Next, click on the **Create a New Product** button.</span>

<span>![embedded-image-racho5om.png](https://openprovider.help/uploads/images/gallery/2026-08/embedded-image-racho5om.png)</span>

4\. <span>Now you have to enter the details for the new product:</span>

- **Product Type**: Select the product type.
- **Product Group**: Choose the desired product group for this product.
- **Product Name**: Enter the product name.
- **Module**: Select the server module (e.g., Openprovider - email solution).
- **Create as Hidden**: Check this option ONLY if you want to keep the product hidden.
    
    After entering all the details, click on **Continue**.
    
    ![embedded-image-7exht9sv.png](https://openprovider.help/uploads/images/gallery/2026-08/embedded-image-7exht9sv.png)

5\. <span>In the Product **'Details'** tab, enter the **tagline**, **short description**, and **full description** for the product. Then, go to the **Pricing** tab and set the product price (Free, One Time, or Recurring). Finally, click **Save Changes**.</span>

<span>![embedded-image-yvctvgwc.png](https://openprovider.help/uploads/images/gallery/2026-08/embedded-image-yvctvgwc.png)</span>

<span>![embedded-image-1bz5zjwz.png](https://openprovider.help/uploads/images/gallery/2026-08/embedded-image-1bz5zjwz.png)</span>

### <span>4. How to configure the product with the server module?</span>

- <span>Go to **Configuration** &gt;&gt; **System Settings &gt;&gt; Find product/service** and click on it.</span>

**![embedded-image-wczklzgf.png](https://openprovider.help/uploads/images/gallery/2026-08/embedded-image-wczklzgf.png)**

- Edit the product and go to the module settings.

<figure id="bkmrk--16">![embedded-image-lhrzqumf.png](https://openprovider.help/uploads/images/gallery/2026-08/embedded-image-lhrzqumf.png)</figure>- Select the **Openprovider Email Solution** <span>server module.</span>

<figure id="bkmrk--17">![embedded-image-vkqn2ehn.png](https://openprovider.help/uploads/images/gallery/2026-08/embedded-image-vkqn2ehn.png)</figure>- 3. <span>In the module configuration options, you need to configure the module with the following settings:</span>
    - **No of Mail**: Enter the number of email accounts you want to offer per order.
    - **Period Billing**: Select the billing period (monthly or yearly).
    - **Description**: Enter the service description. If a Service ID is needed, use the variable
        
        <span>**{$serviceId} - its value will be assigned when the service is created.**</span>
    - **Custom DNS**: Enter the custom DNS values in the following format:
        
        <span>**\[Name/Host | Type | Value | Priority\]**</span>
        
        <span>Eg: </span>  
        <span>@|MX|mail.op-email.eu|0</span>
        
        <span>And for multiple entries, use a new line for each.</span>
    - SMTP: Enter the SMTP port here - **587**
    - IMAP: Enter the IMAP port here - **993**

**Note: Custom mail settings (DNS, SMTP, IMAP) will appear after checkout. Leave these as Default unless you are using a white-labeled mail server.**

4\. <span>After filling all the configurable options, click on the **Save Changes** button.</span>

<span>![embedded-image-ovqr5sqv.png](https://openprovider.help/uploads/images/gallery/2026-08/embedded-image-ovqr5sqv.png)</span>