📌 Purpose & Quick Summary

The Email Accounts manager allows you to create professional, domain-branded email addresses (e.g. [email protected]). Powered by high-performance Postfix MTA and Dovecot IMAP/POP3 daemons, it includes integrated SnappyMail Webmail with 1-click Single Sign-On (SSO), mailbox storage quotas, and password rotation.

BoostonCP Email Accounts Management Overview

Figure 16: Email accounts ledger showing active mailboxes, quota utilization, Webmail SSO, and action buttons.

🖥️ Interface Tour & Elements

  1. Tabs Navigation Bar: Modular tabs: Email Accounts, Forwarders, Catch-All, SMTP Relay, Spam Filter, DNS Diagnostics, and Client Configuration.
  2. Add Mailbox Modal / Form:
    • Email Prefix: Mailbox identifier (e.g. support).
    • Domain Dropdown: Select the target domain.
    • Password Generator: High-entropy password creation.
    • Storage Quota (MB): Maximum disk allocation or Unlimited.
  3. Active Mailboxes Ledger Table: Displays full Email Address, Quota Meter, Log In to Webmail 1-click SSO button, Change Password control, and Delete action.

🛠️ Step-by-Step Instructions

Step 1: Creating a New Email Address

  1. In the sidebar, click Email Accounts (icon: fa-envelope).
  2. Click the Add Mailbox button.
  3. In the dialog:
    • Enter your desired email username (e.g. sales).
    • Select your domain from the dropdown.
    • Click Generate Password and save the generated password securely.
    • Set the storage quota (e.g. 1024 MB for 1GB).
  4. Click Create Mailbox. The mailbox directory structure (/home/user/mail/domain/sales) is initialized instantly.

Step 2: Accessing Webmail via 1-Click SSO

  1. In the mailboxes table, find your email address.
  2. Click the Log In to Webmail button.
  3. BoostonCP authenticates via an encrypted token and launches SnappyMail Webmail in a new tab without prompting for login credentials.

Step 3: Changing a Mailbox Password

  1. Locate the mailbox in the ledger.
  2. Click the Change Password (key icon) button.
  3. Enter or generate a new password and click Update Password.

⚙️ Complete Field & Parameter Reference Table

Field Name Type Recommended Value Operational Impact
Email Prefix Alphanumeric contact, support, hello Identifies individual virtual mailbox under domain.
Domain Dropdown Active account domains Destination domain configured in Postfix virtual maps.
Password Password string 12+ chars, mixed symbols Required for IMAP/SMTP client connections (Outlook, iPhone).
Storage Quota Megabytes (MB) 1024 MB (1 GB) Prevents email inboxes from exhausting total hosting disk space.

❓ Troubleshooting & Common Errors

1. Webmail SSO Returns "Authentication Error"

  • Cause: The mail daemon password salt was desynchronized after an account restoration.
  • Solution: Click Change Password next to the mailbox, save a fresh password, and retry launching Webmail SSO.