Mailcow

Connect a mailcow server to sell email hosting. WISECP creates the mail domain, applies its limits and lets clients manage their mailboxes.

Opening the Screen

Open Products → Hosting & Servers → Server Settings → Add New Server. Under Server Automation Module → Email Hosting, select Mailcow.

{admin}/products/servers-add. Click an existing server’s name to edit it.

Before You Connect

Mailcow signs in with one read-write API key. In the mailcow interface, open Configuration → Access → API and generate a key. Allow your WISECP server IP there, or enable Skip IP check. mailcow documentation.

Use a Hosting product. Every service needs a domain, because the module creates one mail domain per service. Product prices and billing currency are set in WISECP.

Connection and Product Settings

Module Configuration

On the product’s Automation tab, these fields appear in Module Configuration after choosing the server. Quotas are entered in megabytes.

Add-on Parameters

Add-ons raise the limits of one service without changing its product. On an add-on option’s row, click API Settings and expand Mailcow. All three fields are optional.

Tasks

Connect and Check

1. Enter Address / Hostname and API Key under Connection Details, then click Test Connection in that section.
2. A successful test confirms the host and the key. It does not create anything on the mailcow server.
3. Click Add New Server. Confirm the server appears in the list; editing uses Save Changes.

Map the Product

1. Open a Hosting product’s Automation tab. Select Mailcow in Module Assignment and choose the server.
2. Fill Module Configuration with the limits of this plan.
3. Click Save Changes. Reopen Automation to verify the values.

When a service is activated, the module creates the mail domain with these limits and its DKIM key. It also creates a domain administrator, which becomes the client’s sign-in.

Sell Extra Limits as Add-ons

1. Create the add-on as described in Creating a Product Addon and choose its type.
2. On each option’s row, click API Settings, expand Mailcow and enter the values. Click Save Changes.
3. Link the add-on to the product in Product Addon Configuration. Active add-ons then raise the limits on the mailcow server.

The type decides how the values are counted. With Quantity Input, the client picks a quantity and each value is multiplied by it. With Dropdown, Radio Selection or Checkbox, the quantity is always one. Write the full amount on each option, for example 5 for a “+5 mailboxes” option.

Suspending or cancelling an add-on removes its share from the domain limits. Activating it again restores the share. An add-on the client cancels stays active until its period ends. Product upgrades keep the active add-ons. With Calculate Domain Quota on, extra mailboxes also raise the calculated quota.

Import Existing Domains

1. Open the saved server’s Import tab and click List Results. The list shows each mail domain with its domain administrator.
2. Select domains and match each to a client, product, billing cycle, start and end dates.
3. Click Import below the list. Importing links existing domains and does not create new ones.

Manage Services and Client Tools

Open an existing service and select Management. Administrators can create, suspend, unsuspend, terminate, change the password and upgrade the domain. See Service Management for action windows and confirmations.

Clients open their service’s Management tab to use Mailboxes, Aliases, Sync Jobs, App Passwords, Spam Filter and DKIM. Panel sign-in opens mailcow as the domain administrator. The DKIM tool shows the DNS record and can regenerate the key.

Disk space, mailbox and message counts are available as usage metrics. Scheduled usage collection updates the enabled metrics.

Things to Watch

Required Privileges

Server access requires MODULES_SERVERS_SETTINGS; product and add-on changes require PRODUCTS_OPERATION. Service actions need the corresponding service privileges.

Related Articles

• Adding a Server
• Product Automation
• Creating a Product Addon
• Addons of a Service