Introduction & Overview

DomainWarmupSuite is a complete self-hosted email warmup and deliverability platform. It installs on your own web hosting account — you own the software, control the data, and pay once for a lifetime license.

How it works

Key features

System Requirements

Hosting requirements

Email sending requirements

• A dedicated or clean shared IP address
• Exim mail server (standard on cPanel)
• PTR/rDNS record — set by your hosting provider on request
• DKIM signing enabled in cPanel → Email Deliverability
• SPF record in DNS pointing to your server

Installation Guide

Step 1 — Upload files

1. Download and extract your DomainWarmupSuite ZIP package
2. Open cPanel → File Manager → navigate to public_html/
3. Upload all files from the extracted folder
4. Alternatively use FTP to upload to public_html/

Step 2 — Run the installer

Open your browser and navigate to:

https://yourdomain.com/install/

Installer Step 1 — System Check

Verifies PHP extensions and server requirements. Green = OK. If red — contact hosting to enable missing extensions or change PHP version in cPanel → MultiPHP Manager.

Installer Step 2 — Database

Installer Step 3 — Site Configuration

• Site Name — shown in admin panel and emails
• Site URL — full URL with https:// (e.g. https://yourdomain.com)
• Admin Email — your email for system notifications

Installer Step 4 — License Key

Enter your license key received by email after purchase. The key is verified against licenses.domainwarmupsuite.com in real time. Your plan limits (domains, seeds, users) are set from the server response.

Installer Step 5 — Database Tables

Creates all 17 database tables and seeds them with default data including 51 email templates, warmup schedule and alert settings.

Installer Step 6 — Complete

Shows your cron job commands to copy, admin panel link and post-installation checklist.

Post-Installation Setup

Configure cron jobs

Go to cPanel → Cron Jobs and add both jobs. Replace USERNAME with your cPanel username.

Send engine — Every hour

0 * * * * /usr/local/bin/php /home/USERNAME/public_html/cron/warmup_send.php >> /home/USERNAME/public_html/config/cron.log 2>&1

Reply engine — Every 30 minutes

*/30 * * * * /usr/local/bin/php /home/USERNAME/public_html/cron/warmup_reply.php >> /home/USERNAME/public_html/config/cron.log 2>&1

Add your first domain

1. Go to Admin Panel → Domains → Add Domain
2. Enter your domain name (e.g. yourdomain.com)
3. Select SMTP Mode: Same Server for cPanel/Exim, or External SMTP for Gmail/SendGrid
4. Set From Email (e.g. send@yourdomain.com)
5. Click Save Domain

Verify DNS authentication

1. Go to Admin Panel → DNS Checker
2. Select your domain and click Run DNS Check
3. SPF, DKIM, DMARC and PTR should all show green
4. Fix any red items before starting warmup

Plans & Pricing

DomainWarmupSuite is available in 4 plans. All plans include a lifetime license (never expires), all 18 modules and full White Label. The differences are limits and the exclusive License Manager in Enterprise.

What "Lifetime" means

Lifetime license means the license key never expires. You pay once and the software works forever. Future updates are also included at no extra cost. There are no renewal fees, no monthly charges and no per-domain fees.

Plan limits enforcement

Plan limits are enforced live from the license server. When you try to add more domains, seeds or users than your plan allows, you will see an error message with the current limit. Upgrade your license at any time by purchasing a higher plan.

License Activation

Activating your license

1. Your license key is sent by email after purchase
2. Enter it during installation at Step 4, or later in Admin Panel → License
3. Click Activate License — the key is verified in real time
4. Your plan details and limits are loaded from the license server

How verification works

Every 24 hours, the warmup cron checks your license against licenses.domainwarmupsuite.com. The result is cached locally for 25 hours. If the server is unreachable, a 7-day grace period applies automatically.

License status badge

Your license status is shown in Admin Panel → License and in the sidebar plan badge:

• Active ∞ Lifetime — license is valid and verified
• Grace Period — server unreachable, using cached result (up to 7 days)
• Invalid — key not found, suspended or grace period expired

All 18 Modules

DomainWarmupSuite ships with 18 fully built modules. All are included in every plan.

Warmup Engine — Deep Dive

How it works

Two cron jobs power the engine: warmup_send.php sends emails, warmup_reply.php connects to seed inboxes and replies. Together they simulate natural email correspondence.

The 42-day schedule

Cron heartbeat monitor

The dashboard shows color-coded dots for each cron:

• Green — ran less than 1 hour ago
• Yellow — ran 1–2 hours ago
• Red — not run for over 2 hours — action required

DKIM signing

DomainWarmupSuite sends via PHP mail() which routes through Exim. When DKIM is enabled in cPanel → Email → Email Deliverability, Exim automatically signs every outgoing email — including warmup emails. No additional configuration needed.

Seed Accounts Setup

Types of seeds

Setting up Gmail seeds

1. Go to Google Account → Security → 2-Step Verification → Enable
2. Go to Security → App Passwords → Create (Mail + Custom name)
3. Copy the 16-character app password shown
4. In DomainWarmupSuite: Seed List → Add Seed → External → Gmail
5. Enter the Gmail address and the App Password (not your Google password)

IMAP Host: imap.gmail.com
Port: 993  |  Encryption: SSL

Setting up internal (cPanel) seeds

1. cPanel → Email Accounts → Create Account (e.g. seed1@yourdomain.com)
2. DomainWarmupSuite → Seed List → Add Seed → Internal (cPanel)

IMAP Host: mail.yourdomain.com
Port: 993  |  Encryption: SSL
Username: seed1@yourdomain.com

DNS & Authentication Setup

SPF Record

Type:  TXT
Name:  @ (or yourdomain.com)
Value: v=spf1 ip4:YOUR.SERVER.IP ~all

DKIM — Enable in cPanel

1. cPanel → Email → Email Deliverability
2. Find your domain → click Manage
3. If DKIM shows "Not installed" — click Install
4. Exim now signs all outgoing emails automatically

DMARC Record

Type:  TXT
Name:  _dmarc.yourdomain.com
Value: v=DMARC1; p=none; rua=mailto:dmarc@yourdomain.com

PTR / Reverse DNS

PTR is set by your hosting provider — not in your DNS panel. Contact hosting support and ask: "Please set the PTR record for IP [your IP] to mail.yourdomain.com"

Cron Jobs Configuration

Add both cron jobs in cPanel → Cron Jobs. Replace USERNAME with your cPanel username (shown in Step 6 of the installer).

Send engine — Every hour

0 * * * * /usr/local/bin/php /home/USERNAME/public_html/cron/warmup_send.php >> /home/USERNAME/public_html/config/cron.log 2>&1

Reply engine — Every 30 minutes

*/30 * * * * /usr/local/bin/php /home/USERNAME/public_html/cron/warmup_reply.php >> /home/USERNAME/public_html/config/cron.log 2>&1

Verify crons are running

1. Wait at least 1 hour after adding crons
2. Admin Panel → Dashboard — heartbeat dots should be green
3. Check /config/cron.log in File Manager for output

White Label Configuration

Go to Admin Panel → White Label to configure all branding settings.

License Manager Enterprise Only

Installing the license server

1. Create a subdomain in cPanel (e.g. licenses.yourdomain.com)
2. Create a new MySQL database for the license server
3. Upload the license-server/ files to the subdomain root
4. Open licenses.yourdomain.com/install.php
5. Complete the 3-step installer: Database → Admin Account → Install
6. Delete install.php after completion

The 4 default plans

Creating and sending a license

1. Log in to licenses.yourdomain.com/admin/
2. Licenses → New License
3. Select plan, enter customer name and email
4. Set duration: Lifetime (never expires) or fixed days
5. Click Create License — key is auto-generated
6. Click the email icon to send the key to the customer

How client verification works

Every 24 hours, DomainWarmupSuite checks the license key against your license server. If the server is unreachable, a 7-day grace period applies. If the license expires or is suspended, an alert email is sent to the admin.

REST API Reference

Authentication

Generate an API key in Admin Panel → API → Generate API Key. Pass it via header or query parameter:

Authorization: Bearer YOUR_API_KEY

# or as query parameter:
?api_key=YOUR_API_KEY

Base URL

https://yourdomain.com/api/v1/

Rate limiting

1,000 requests per hour per API key. Returns HTTP 429 when exceeded.

All endpoints

Troubleshooting

Emails going to spam

Cron not running

HTTP 500 errors

License not verifying

IMAP connection errors (seeds)

Frequently Asked Questions

How long does warmup take?

A complete warmup is 42 days. Most users see significant inbox placement improvement after Day 14–21, especially when DNS is fully configured and seeds are active.

What is the difference between the 4 plans?

All plans include all 18 modules, White Label and lifetime license. The differences are: Basic (5 domains / 20 seeds / 2 users / $67), Pro (10 / 50 / 5 / $127), Agency (50 / 200 / 20 / $247), Enterprise (unlimited / unlimited / unlimited / $497 + License Manager).

Does White Label really come with every plan?

Yes — every plan from Basic upwards includes full White Label. You can rebrand completely with your own logo, colors and domain name even on the $67 Basic plan.

What is the License Manager and who needs it?

The License Manager (Enterprise only) lets you deploy your own license server and sell access to DomainWarmupSuite to your clients under your own brand. If you want to resell warmup as a SaaS service, you need Enterprise. If you just want to use warmup yourself (even for client domains), the Agency plan at $247 is sufficient.

Is the license really lifetime?

Yes. You pay once and the license never expires. Future updates are included. No monthly fees, no renewal fees, no per-domain fees.

Can I warm up multiple domains at once?

Yes. Each plan supports multiple domains simultaneously: Basic (5), Pro (10), Agency (50), Enterprise (unlimited). Each domain has its own warmup schedule and reputation tracking.

How many seed accounts do I need?

Start with at least 5–10 seeds across multiple providers. Your plan sets the maximum: Basic (20), Pro (50), Agency (200), Enterprise (unlimited). More diverse seeds = faster reputation building.

Do I need technical skills to install it?

The installer is a 6-step guided wizard similar to WordPress. If you can upload files via cPanel and create a MySQL database, you can install in under 15 minutes. Full documentation is included.

Support & Updates

Before contacting support

• Your license key
• PHP version (Admin Panel → Settings → System Info)
• The exact error message or behavior
• Steps to reproduce the issue
• What you have already tried

Receiving updates

1. You will be notified by email when a new version is available
2. Back up your installation (files + database export)
3. Upload the new files — config and data are preserved
4. Run any migration scripts included with the update