Admin Console (Port 2087)
Email Accounts
Tab 1: Email Accounts
Email Management • Tab 1: Email Accounts • Native 1920x1080 View
📌 Purpose & Quick Summary
Use the Email Accounts tab (Mailbox Manager) to create professional, domain-branded email inboxes (such as [email protected]), manage storage quotas, change passwords, and log into webmail with 1 click via Single Sign-On (SSO).
🖥️ Interface Tour & Elements
When you open this tab, you will see:
- Mail Hostname & Identity Health Banner: Shows your server mail hostname (e.g.,
mail.yourserver.com) and verifies whether system mail services are running properly. - Domain Selector & User Filter: Allows you to filter domains by account owner or search for a specific domain.
- Open Webmail Button: A quick-launch button in the header that opens your SnappyMail webmail interface in a new browser tab.
- Create New Mailbox Card: An interactive form to enter an account username and set a secure mailbox password.
- Active Mailboxes Table: Displays existing email accounts, storage usage, and quick action buttons (Webmail SSO, Change Password, and Delete).
🛠️ Step-by-Step Instructions: Creating a New Email Account
- Select Target Domain:
- In the Target Domain dropdown or the matched domains grid, select the website domain you want to add an email address for (e.g.,
boostoncp.com).
- In the Target Domain dropdown or the matched domains grid, select the website domain you want to add an email address for (e.g.,
- Fill in Mailbox Credentials:
- In the Account User field, enter the username prefix (e.g.,
supportoradmin). The domain suffix (@yourdomain.com) is appended automatically. - In the Set Password field, type a strong password or click the Key Icon button (
generate-password-btn) to automatically generate a secure 16-character password.
- In the Account User field, enter the username prefix (e.g.,
- Create the Mailbox:
- Click the blue Create Email button.
- BoostonCP creates the mailbox directory, sets up cryptographic hashing, and updates the Postfix/Dovecot virtual table within milliseconds.
- Accessing Webmail:
- To access the mailbox immediately without entering a password, find the email address in the table below and click the Webmail (SSO) button.
⚙️ Complete Field & Parameter Reference Table
| Form Element | Expected Input | Description |
|---|---|---|
| Filter by User | Dropdown (All Users or specific user) |
Filters domains owned by a specific tenant or reseller |
| Search Domain | Text Search | Instantly filters the domain selector dropdown |
| Target Domain | Domain Dropdown / Clickable Tile | The specific domain where the mailbox will be created |
| Account User | Text (Alphanumeric, dots, hyphens) | The email username before the @ symbol |
| Set Password | Text / Auto-generated string | Encrypted mailbox password (stored as secure BLF-CRYPT/SHA512) |
| Webmail SSO | 1-Click Action Button | Direct single sign-on authentication into SnappyMail |
❓ Troubleshooting & Common Errors
- Error: "Mailbox user already exists": An email account with that prefix already exists on the selected domain. Choose another prefix or edit the existing account.
- Error: "Package mailbox limit reached": The user hosting this domain has exceeded their allocated email quota in their hosting package. Increase the mailbox limit under Packages or Users.
