{"id":2593,"date":"2026-03-05T19:10:38","date_gmt":"2026-03-05T19:10:38","guid":{"rendered":"https:\/\/cyberpanel.net\/KnowledgeBase\/cybermail-setup-guide\/"},"modified":"2026-03-05T19:10:38","modified_gmt":"2026-03-05T19:10:38","slug":"cybermail-setup-guide","status":"publish","type":"post","link":"https:\/\/cyberpanel.net\/KnowledgeBase\/cybermail-setup-guide\/","title":{"rendered":"CyberMail Email Delivery \u2014 Setup & Administration Guide"},"content":{"rendered":"

CyberMail Email Delivery \u2014 Setup & Administration Guide<\/h1>\n

Feature<\/strong>: CyberMail Email Delivery Integration
\nCyberPanel Version<\/strong>: 2.4.5+
\nPlatform<\/strong>: https:\/\/platform.cyberpersons.com
\nLast Updated<\/strong>: 2026-03-06<\/p>\n

Prerequisites<\/h2>\n
    \n
  1. CyberPanel 2.4.5 or later installed<\/li>\n
  2. Active internet connection from the server<\/li>\n
  3. PowerDNS running (for automatic DNS configuration)<\/li>\n
  4. Postfix installed (for SMTP relay feature)<\/li>\n<\/ol>\n
    \n

    Installation<\/h2>\n

    The CyberMail module is included in CyberPanel 2.4.5+. No separate installation needed.<\/p>\n

    Verify the Module<\/h3>\n
    # Check the app exists\nls \/usr\/local\/CyberCP\/emailDelivery\/\n\n# Check it's in INSTALLED_APPS\ngrep -n "emailDelivery" \/usr\/local\/CyberCP\/CyberCP\/settings.py\n\n# Run migrations if needed\ncd \/usr\/local\/CyberCP\npython manage.py migrate emailDelivery\n<\/code><\/pre>\n
    Database Tables<\/h3>\n
    The module creates two tables:<\/p>\n\n\n\n\n\n\n
    Table<\/th>\nPurpose<\/th>\n<\/tr>\n<\/thead>\n
    cybermail_accounts<\/code><\/td>\nStores per-admin CyberMail account connections<\/td>\n<\/tr>\n
    cybermail_domains<\/code><\/td>\nTracks sending domains and their verification status<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
    \n
    Getting Started<\/h2>\n
    Step 1: Access CyberMail<\/h3>\n
    Navigate to: https:\/\/your-server:8090\/emailDelivery\/<\/strong><\/p>\n
    You’ll see the CyberMail marketing page with plan information and a “Get Started Free” button.<\/p>\n
    Step 2: Connect Your Account<\/h3>\n
      \n
    1. Click “Get Started Free”<\/strong><\/li>\n
    2. Enter your email address (defaults to your CyberPanel admin email)<\/li>\n
    3. Create a password for your CyberMail account<\/li>\n
    4. Click Connect<\/strong><\/li>\n<\/ol>\n
      This registers your account on the CyberMail platform and obtains an API key that’s stored locally for future API calls.<\/p>\n
      \n
      Note<\/strong>: If you already have a CyberMail account on the platform, use the same email and password. The system will link your existing account.<\/p>\n<\/blockquote>\n
      Step 3: Add Sending Domains<\/h3>\n
        \n
      1. After connecting, you’ll see the dashboard<\/li>\n
      2. Go to the Domains<\/strong> tab<\/li>\n
      3. Click “Add Domain”<\/strong><\/li>\n
      4. Enter your domain name (e.g., example.com<\/code>)<\/li>\n
      5. Click Add<\/strong><\/li>\n<\/ol>\n
        The system will:
        \n– Register the domain on the CyberMail platform
        \n– Automatically create SPF, DKIM, and DMARC DNS records in PowerDNS
        \n– Report how many DNS records were configured<\/p>\n
        Step 4: Verify Domain<\/h3>\n
          \n
        1. Click “Verify”<\/strong> next to your domain<\/li>\n
        2. The system checks SPF, DKIM, and DMARC records<\/li>\n
        3. Green checkmarks appear for each verified record<\/li>\n
        4. Status changes to “Verified” when all records pass<\/li>\n<\/ol>\n
          \n
          DNS Propagation<\/strong>: If verification fails immediately after adding, wait 5-10 minutes for DNS propagation and try again.<\/p>\n<\/blockquote>\n
          Step 5: Enable SMTP Relay (Optional)<\/h3>\n
          The SMTP relay routes ALL outgoing email from your server through CyberMail:<\/p>\n
            \n
          1. Go to the Relay<\/strong> tab<\/li>\n
          2. Click “Enable Relay”<\/strong><\/li>\n
          3. The system will:<\/li>\n
          4. Create (or rotate) SMTP credentials on the platform<\/li>\n
          5. Configure Postfix with the relay host (mail.cyberpersons.com:587<\/code>)<\/li>\n
          6. Set up SASL authentication<\/li>\n
          7. Enable TLS encryption<\/li>\n<\/ol>\n
            What gets configured in Postfix<\/strong> (\/etc\/postfix\/main.cf<\/code>):<\/p>\n
            relayhost = [mail.cyberpersons.com]:587\nsmtp_sasl_auth_enable = yes\nsmtp_sasl_password_maps = hash:\/etc\/postfix\/sasl_passwd\nsmtp_sasl_security_options = noanonymous\nsmtp_tls_security_level = encrypt\n<\/code><\/pre>\n
            \n
            Dashboard Overview<\/h2>\n
            After connecting, the dashboard provides five tabs:<\/p>\n
            Domains Tab<\/h3>\n
              \n
            • Lists all sending domains with verification status<\/li>\n
            • SPF, DKIM, DMARC status badges (green = verified)<\/li>\n
            • Actions: Verify, Auto-Configure DNS, Remove<\/li>\n
            • DNS auto-configuration works when the domain exists in PowerDNS<\/li>\n<\/ul>\n
              SMTP Tab<\/h3>\n
                \n
              • Manage SMTP credentials for sending<\/li>\n
              • Create new credentials with descriptions<\/li>\n
              • Rotate passwords (one-time display)<\/li>\n
              • Delete unused credentials<\/li>\n<\/ul>\n
                Relay Tab<\/h3>\n
                  \n
                • Shows current relay status (Enabled\/Disabled)<\/li>\n
                • Displays relay host and port<\/li>\n
                • Enable\/Disable toggle<\/li>\n
                • Relay info: mail.cyberpersons.com:587<\/code> with STARTTLS<\/li>\n<\/ul>\n
                  Logs Tab<\/h3>\n
                    \n
                  • Paginated delivery logs<\/li>\n
                  • Filter by: Status (delivered\/bounced\/failed), Days (1-30)<\/li>\n
                  • Shows: Date, From, To, Subject, Status<\/li>\n
                  • Color-coded status badges<\/li>\n<\/ul>\n
                    Stats Tab<\/h3>\n
                      \n
                    • Aggregate stats: Total Sent, Delivered, Bounced, Failed, Delivery Rate<\/li>\n
                    • Per-domain breakdown table<\/li>\n
                    • Useful for identifying domains with deliverability issues<\/li>\n<\/ul>\n
                      \n
                      Plans & Pricing<\/h2>\n\n\n\n\n\n\n\n\n
                      Plan<\/th>\nPrice<\/th>\nEmails\/Month<\/th>\nFeatures<\/th>\n<\/tr>\n<\/thead>\n
                      Free<\/strong><\/td>\n$0<\/td>\n15,000<\/td>\nShared infrastructure, basic analytics<\/td>\n<\/tr>\n
                      Starter<\/strong><\/td>\n$15\/mo<\/td>\n100,000<\/td>\nPriority support, advanced analytics<\/td>\n<\/tr>\n
                      Professional<\/strong><\/td>\n$90\/mo<\/td>\n500,000<\/td>\nDedicated IPs, custom DKIM, webhooks<\/td>\n<\/tr>\n
                      Enterprise<\/strong><\/td>\n$299\/mo<\/td>\n2,000,000<\/td>\nSLA guarantee, account manager, custom limits<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
                      Upgrade at: https:\/\/platform.cyberpersons.com<\/p>\n
                      \n
                      Promotional Banners<\/h2>\n
                      CyberMail banners appear on email-related pages to inform users about the delivery service:<\/p>\n
                        \n
                      • Mail Functions (\/mailServer\/<\/code>)<\/li>\n
                      • Create Email Account<\/li>\n
                      • DKIM Manager<\/li>\n
                      • Webmail<\/li>\n
                      • Email Premium<\/li>\n
                      • Email Marketing<\/li>\n<\/ul>\n
                        Banners are dismissible with a 7-day cookie-based suppression. They show:
                        \n– “Stop Landing in Spam” headline
                        \n– Brief feature description
                        \n– “Get Started Free” CTA linking to \/emailDelivery\/<\/code><\/p>\n
                        \n
                        Disconnecting<\/h2>\n
                          \n
                        1. Go to https:\/\/your-server:8090\/emailDelivery\/<\/strong><\/li>\n
                        2. Click the “Disconnect”<\/strong> button<\/li>\n
                        3. Confirm the action<\/li>\n<\/ol>\n
                          Disconnecting will:
                          \n– Disable SMTP relay if active (remove Postfix relay config)
                          \n– Clear the stored API key
                          \n– Remove local domain records
                          \n– Reset SMTP credential references<\/p>\n
                          \n
                          Note<\/strong>: Your CyberMail platform account is NOT deleted. You can reconnect later with the same credentials.<\/p>\n<\/blockquote>\n
                          \n
                          Troubleshooting<\/h2>\n
                          “Account not connected” error<\/h3>\n
                          The admin session doesn’t have an active CyberMail connection. Click “Get Started Free” to connect.<\/p>\n
                          DNS records not auto-configured<\/h3>\n
                            \n
                          • The domain must exist in PowerDNS on this server<\/li>\n
                          • Check if the domain was created via CyberPanel’s DNS management<\/li>\n
                          • If using external DNS, add records manually using the DNS records shown on the platform<\/li>\n<\/ul>\n
                            Domain verification failing<\/h3>\n
                              \n
                            • Wait 5-10 minutes after DNS changes for propagation<\/li>\n
                            • Verify records exist: dig TXT example.com +short<\/code><\/li>\n
                            • Check for conflicting SPF records (only one SPF record allowed per domain)<\/li>\n<\/ul>\n
                              SMTP relay not working<\/h3>\n
                                \n
                              • Check Postfix status: systemctl status postfix<\/code><\/li>\n
                              • Verify relay config: grep relayhost \/etc\/postfix\/main.cf<\/code><\/li>\n
                              • Check SASL credentials: cat \/etc\/postfix\/sasl_passwd<\/code><\/li>\n
                              • Test connectivity: telnet mail.cyberpersons.com 587<\/code><\/li>\n
                              • Check mail queue: mailq<\/code><\/li>\n
                              • View Postfix logs: tail -f \/var\/log\/mail.log<\/code><\/li>\n<\/ul>\n
                                Relay shows “Failed to configure”<\/h3>\n
                                  \n
                                • Ensure \/usr\/local\/CyberCP\/plogical\/mailUtilities.py<\/code> has the configureRelayHost<\/code> method<\/li>\n
                                • Check file permissions on \/etc\/postfix\/sasl_passwd<\/code><\/li>\n
                                • Verify Postfix is installed and running<\/li>\n<\/ul>\n
                                  Emails still going to spam<\/h3>\n
                                    \n
                                  1. Verify all DNS records (SPF, DKIM, DMARC) are green<\/li>\n
                                  2. Check your domain’s reputation at https:\/\/www.mail-tester.com<\/li>\n
                                  3. Ensure you’re not sending to purchased\/scraped lists<\/li>\n
                                  4. Consider upgrading to a plan with dedicated IPs<\/li>\n<\/ol>\n
                                    \n
                                    File Reference<\/h2>\n\n\n\n\n\n\n\n\n\n\n\n
                                    File<\/th>\nPurpose<\/th>\n<\/tr>\n<\/thead>\n
                                    emailDelivery\/emailDeliveryManager.py<\/code><\/td>\nCore business logic, platform API calls<\/td>\n<\/tr>\n
                                    emailDelivery\/models.py<\/code><\/td>\nDatabase models (CyberMailAccount, CyberMailDomain)<\/td>\n<\/tr>\n
                                    emailDelivery\/views.py<\/code><\/td>\nDjango view functions (thin wrappers)<\/td>\n<\/tr>\n
                                    emailDelivery\/urls.py<\/code><\/td>\nURL routing (18 endpoints)<\/td>\n<\/tr>\n
                                    emailDelivery\/static\/emailDelivery\/emailDelivery.js<\/code><\/td>\nAngularJS controller<\/td>\n<\/tr>\n
                                    emailDelivery\/templates\/emailDelivery\/index.html<\/code><\/td>\nSingle-page template (marketing + dashboard)<\/td>\n<\/tr>\n
                                    plogical\/mailUtilities.py<\/code><\/td>\nPostfix relay configuration (configureRelayHost\/removeRelayHost)<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
                                    \n
                                    Security<\/h2>\n
                                      \n
                                    • API keys are stored per-admin in the local database, never in config files<\/li>\n
                                    • All platform API calls use HTTPS with Bearer token authentication<\/li>\n
                                    • SMTP credentials use SASL over TLS (STARTTLS on port 587)<\/li>\n
                                    • SASL password file is chmod 600 (root-only readable)<\/li>\n
                                    • Session-based authentication with CSRF protection on all endpoints<\/li>\n
                                    • Passwords are never stored locally \u2014 only on the platform<\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"
                                      CyberMail Email Delivery \u2014 Setup & Administration Guide Feature: CyberMail Email Delivery Integration CyberPanel Version: 2.4.5+ Platform: https:\/\/platform.cyberpersons.com Last Updated: 2026-03-06 Prerequisites CyberPanel 2.4.5 or later installed Active internet connection from the server PowerDNS running (for automatic DNS configuration) Postfix installed (for SMTP relay feature) Installation The CyberMail module is included in CyberPanel 2.4.5+. No […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[108],"tags":[],"class_list":["post-2593","post","type-post","status-publish","format-standard","hentry","category-email-service"],"_links":{"self":[{"href":"https:\/\/cyberpanel.net\/KnowledgeBase\/wp-json\/wp\/v2\/posts\/2593","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/cyberpanel.net\/KnowledgeBase\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/cyberpanel.net\/KnowledgeBase\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/cyberpanel.net\/KnowledgeBase\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/cyberpanel.net\/KnowledgeBase\/wp-json\/wp\/v2\/comments?post=2593"}],"version-history":[{"count":0,"href":"https:\/\/cyberpanel.net\/KnowledgeBase\/wp-json\/wp\/v2\/posts\/2593\/revisions"}],"wp:attachment":[{"href":"https:\/\/cyberpanel.net\/KnowledgeBase\/wp-json\/wp\/v2\/media?parent=2593"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/cyberpanel.net\/KnowledgeBase\/wp-json\/wp\/v2\/categories?post=2593"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/cyberpanel.net\/KnowledgeBase\/wp-json\/wp\/v2\/tags?post=2593"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}