Mailcow Import Export Tool

Tired of wrestling with one-by-one edits in Mailcow’s admin panel? The Mailcow Import Export Tool is built to take the pain out of large-scale email server changes. Whether you’re onboarding an entire company, migrating hundreds of users, or just keeping your domains neat and tidy, this PHP-based web interface makes it fast, accurate, and repeatable.

With full CSV support, manual entry options, and direct integration with the official Mailcow API, you can manage domains, mailboxes, and aliases in bulk—without touching the database or risking downtime. From one central dashboard, you’ll import, export, analyze, and monitor your Mailcow instance like a pro.

Why you’ll love it

• 🚀 Bulk everything – Upload a CSV, hit “Go,” and watch hundreds of mailboxes or aliases appear in seconds.
• 🛡 Safe & API-only – No direct database writes, just secure, authenticated API calls.
• 🌓 Looks great anywhere – Responsive Bootstrap 5 UI with automatic dark mode.
• 📊 Stay in control – Domain analyzer, outbound email monitor, and sync tools included.
• 💾 Built-in backups – Export all objects to CSV for audits or off-platform storage.
• 🔒 Locked down – Password gate, CSRF protection, and optional IP allowlist keep things secure.

Perfect for:

• System administrators running multi-tenant Mailcow setups
• Hosting providers onboarding/offboarding large client batches
• MSPs managing recurring maintenance for customer email systems

Stop clicking through endless admin pages. Bulk manage your Mailcow the smart way.

Features

📥 Mailbox Batch Operations

Create multiple mailboxes at once with custom passwords, quotas, forwarding rules, and force-password-change options.

🌐 Domain Migration Tools Add, transfer, or deactivate domains in bulk, complete with descriptions and quota settings.

📂 Full CSV Import/Export Seamless migration between Mailcow instances or backup to disk—supports UTF-8 and large file sizes.

✏ Manual Entry Interface Perfect for small changes without uploading a CSV—just fill out the form and save.

🧪 Domain Analyzer Run instant configuration checks to verify DNS, quota, and activity status for each domain.

📈 Outbound Email Monitor Track outbound message counts to spot unusual activity before it becomes a problem.

🔄 Sync Manager Keep your Mailcow instance synchronized with an external “source of truth” file or system.

Requirements

• PHP 8.1 or higher – with curl, json, and openssl extensions enabled
• Web server – Apache or Nginx (HTTPS strongly recommended)
• Mailcow server – running and accessible over HTTPS
• Mailcow API key – with permissions for domains, mailboxes, and aliases

Instructions

For full instructions see this post: Full Documentation

Configure the Tool

1. Open the configuration file Navigate to includes/config.php in the tool’s folder.

Edit with your specific settings:

<strong>
<b>
<?php
// includes/config.php

// Base URL of the Mailcow instance (no trailing slash)
$mailcow_base_url = 'https://mail.yourdomain.com';

// Mailcow API key with appropriate permissions
$mailcow_api_key = 'YOUR_API_KEY_HERE';

// Password to protect access to the tool
$password_protect = 'YOUR_SECURE_PASSWORD_HERE';

// Optional: Site name for branding
$site_name = 'Mailcow Management Tools';

// Optional: Base URL for magic links (if using Fail2ban manager)
$site_base_url = 'https://tools.yourdomain.com';
?>


</b>

</strong>

Configuration Parameters Explained:

$mailcow_base_url – Full URL to your Mailcow instance (no trailing slash).

$mailcow_api_key – Mailcow API key with read/write permissions for domains, mailboxes, and aliases.

$password_protect – Strong password to restrict access to the tool.

$site_name – Optional branding text for the tool’s interface.

$site_base_url – Optional URL used for generating certain links in advanced features.

Save and test:

Make sure your server has PHP 8.1+ with curl, json, and openssl enabled.