# Mailcow https://docs.wisecp.com/de/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](https://docs.mailcow.email/). 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 - **Address / Hostname**: Required. Enter the mailcow host without a URL path. HTTPS port: 443. - **API Key**: Required. Paste the read-write key. A read-only key cannot create domains. - **Verify SSL Certificate**: Keep HTTPS and certificate verification enabled on live servers. ### Module Configuration On the product’s **Automation** tab, these fields appear in **Module Configuration** after choosing the server. Quotas are entered in megabytes. - **Max Mailboxes / Max Aliases**: Required domain limits. Defaults: 10 mailboxes and 50 aliases. - **Total Domain Quota (MB)**: Required. Storage shared by all mailboxes of the domain. Default: 10240. - **Max Quota per Mailbox (MB) / Default Mailbox Quota (MB)**: Required. Defaults: 10240 and 3072. The default quota cannot exceed the maximum. - **Calculate Domain Quota**: Optional. When on, the domain quota is Max Quota per Mailbox × Max Mailboxes. Total Domain Quota is then ignored. - **DKIM Selector / DKIM Key Size**: Signing key settings for new domains. Defaults: dkim and 2048 bit. ### 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. - **Extra Mailboxes**: Mailboxes added to Max Mailboxes. - **Extra Domain Quota (MB)**: Megabytes added to the domain quota. Enter 1024 for 1 GB. - **Extra Aliases**: Aliases added to Max Aliases. ## 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](https://docs.wisecp.com/en/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](https://docs.wisecp.com/en/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](https://docs.wisecp.com/en/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 > **Data Loss** > > Termination deletes the domain’s mailboxes and aliases, then the domain and its administrator on the mailcow server. Suspension only deactivates the domain and keeps the mail. After regenerating a DKIM key, update the DNS TXT record. ## 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](https://docs.wisecp.com/en/adding-a-server) - [Product Automation](https://docs.wisecp.com/en/product-automation) - [Creating a Product Addon](https://docs.wisecp.com/en/creating-a-product-addon) - [Addons of a Service](https://docs.wisecp.com/en/addons-of-a-service)