Email Accounts

URL: /client/email-accounts-page

Manage your email accounts easily. Create, view, and organize all your email addresses in one place.

Overview

The Email Accounts interface provides centralized management for all email addresses on your account. Create new accounts, configure settings, and monitor usage from a single dashboard.

Internationalised domains

Mailboxes on a domain with a non-ASCII name work the same as any other. The domain dropdown and the Account @ Domain column show the readable Unicode form, while the mail server stores and routes the address using the Punycode form. See Internationalised domain names.

For detailed documentation, visit docs.adminbolt.com.

Create Email Account

Click the "Create Email Account" button to add a new email address to your account. The form includes the following fields:

Create email account

• Username (text, required) - The local part of the email address (the part before the @ symbol)
• Domain (dropdown, required) - Select which domain this email account will use. Since panel 1.9.3, the first of your domains is selected when the form opens, so a mailbox on that domain can be created without changing it.
• Password - Choose how to set your password:
  • Select "Set now" to create a password immediately
    • Password (password, required) - Enter your desired password
    • Confirm Password (password, required) - Re-enter your password to confirm
    • Password Strength - Visual indicator showing your password strength
  • Select "Send to email" to have a secure link sent to your email
• Quota (number) - Set the maximum mailbox size in MiB (mebibytes). Leave blank for unlimited storage.

Form buttons: Create, Cancel

Mail on a free temporary domain

Since panel 1.9.4 the page warns you about mail on a free temporary domain, the domain included with the server that you can use before your own domain points at it. Public DNS for that domain publishes only its A record, so its MX, SPF, and DKIM records never reach other mail providers. The warning Mail on a free temporary domain reads:

Mail sent from an address on a free temporary domain may fail SPF and DKIM checks at other mail providers and land in spam or bounce, because public DNS for this domain publishes only its A record. To send mail, use your own domain and publish its SPF and DKIM records where its DNS is hosted.

It appears above the list of email accounts when one of your mail domains is a free temporary domain or a name under one, followed by Domains affected: and those domains. In the Create Email Account form it appears as soon as you pick such a domain. The warning does not block anything: the mailbox is still created.

The same warning is shown in the Zone Editor while you manage the zone of such a domain, on the Dashboard under Free temporary domains, and on the last screen of the server's first-run setup when the website address it hands out is on that domain. DNS Health checks the mail records of the domain in public DNS.

Find Accounts

Use the search bar to quickly locate email accounts by searching for account names or associated domains.

Account Management

When email accounts exist, the table displays:

• Account @ Domain: The full email address.
• Restrictions: Any sending or access limitations, each named, for example Sending suspended, Incoming suspended, or Login suspended. A suspension of outgoing mail shows as a single Sending suspended label, followed by who suspended it (see Who suspended sending). A mailbox with no restrictions is shown as Unrestricted.
• Usage: Current mailbox usage.
• Quota: Maximum mailbox size allowed.
• Import: The status of an IMAP import for this mailbox (see Import a mailbox from another provider).
• Actions: Login to Webmail, Edit, Connect Devices, and Import Mailbox.

Empty State

If you have no email accounts, the interface displays "No Email Accounts" with a message "Create an email account to get started."

Account Actions

Each email account has the following options:

• Login to Webmail: Access webmail directly from the panel. Mail filters are managed in webmail (Roundcube); the client panel has no page for them.
• Edit: Modify account settings and configuration.
• Connect Devices: Configure email access on external devices. When you set up a mail client, the incoming and outgoing mail server address is mail.<your-domain> if the domain's mail certificate is active; otherwise, use the server hostname shown in the connection details.
• Import Mailbox: Copy messages from a mailbox at another provider into this account over IMAP (see Import a mailbox from another provider).
• Suspend Sending / Restore Sending: Stop or allow outgoing mail for the address (see Suspending outgoing mail).

Suspending outgoing mail

A mailbox that sends spam, for example because its password leaked, can be stopped from sending without closing it. There are two places to do it, and since panel 1.9.0 they are one setting:

• Suspend Sending on the mailbox's row, and Restore Sending to lift it.
• Outgoing mail in the mailbox's Edit form, set to Suspend or Allow.

A suspension stops all mail sent as that address: mail sent from a mail client or webmail, and mail that scripts on your website send as the address. The mailbox still receives mail and can still be read over IMAP and in webmail. The Edit form always shows the current state, whichever place the suspension was made in, and saving the form without changing Outgoing mail leaves it as it is.

Who suspended sending

Since panel 1.9.3 the panel records who suspended sending, and the Restrictions column names it after the label, for example Sending suspended (suspended by: Client):

Suspended by	Meaning
Client	You suspended sending yourself, on the row or in the Edit form.
Automatic (sending limit)	The mailbox went over its sending limit. The label shows until when, for example Sending suspended until 2026-10-21 14:00.
Administrator	Your hosting provider suspended sending.
N/A	Sending was suspended before the panel recorded who did it, or the suspension came back with a restore from a backup.

You can lift only a suspension you set yourself. While sending is suspended by the sending limit, by your hosting provider, or with no record of who did it, Restore Sending and the Outgoing mail switch are disabled, and their note says why and, for the sending limit, when sending returns:

• "Sending for address was suspended automatically because it went over the sending limit, so it cannot be changed here. It is restored on its own at time UTC, or your hosting provider can restore it sooner."
• "Sending for address was suspended by your hosting provider, so it cannot be changed here."
• "Sending for address is suspended and the panel does not record who suspended it, so it cannot be changed here."

Ask your hosting provider to restore sending in the last two cases. The same rule applies to a reseller signed in to your account and to the client API. Your hosting provider can lift any suspension.

The mailbox API

The client REST API manages mailboxes under /api/client/email-accounts; see the API reference. Since panel 1.9.3:

• Passwords. A password set with password (or new_password) on PUT or PATCH /api/client/email-accounts/{id} follows the rules of the Edit form: a text of at least 6 characters, and when you also send password_confirmation (or new_password_again), it must match. A refused password is answered with 422, and the mailbox keeps its old password. An accepted one is saved and applied to the mail server. If the mail server cannot be reached or updated, the answer is still 200, but its warning says the mailbox was updated in the panel only and next_step says what to do: resolve the reported cause, then send the update again.
• Accepted fields. Creating and updating a mailbox accepts the fields the panel's forms offer, such as quota, receive_incoming_email, logging_in, and sending_outgoing_email (allow or suspend); name is accepted on update only. A field outside the accepted ones is refused with 422, and the message names every such field and lists the accepted ones. The fields that record a sending suspension can never be set directly and are refused with their own message: suspend or restore sending with sending_outgoing_email. On update, a change of domain_id, username, or hosting_account_id is refused as well. A refused request writes nothing.
• Sending. sending_outgoing_email works like the Outgoing mail switch, including the rule above: while a suspension you did not set is in force, a change of sending is refused with 422 and the reason, and nothing in the request is written. A new mailbox created with sending_outgoing_email set to suspend counts as your own suspension.

The administrator API under /api/hosting-account/email-accounts follows the same password and field rules, and can lift any suspension.

Import a mailbox from another provider (IMAP)

Use Import Mailbox next to an account to copy its messages from a mailbox hosted at another provider over IMAP. This is useful when you move an address to AdminBolt and want to bring across the existing mail.

Selecting Import Mailbox opens the "Import mail into ..." dialog, where the title includes the target mailbox address. Complete the connection details for the source mailbox:

• Source IMAP server (required) - The hostname or IPv4 address of the provider's IMAP server, for example imap.example.com.
• Port (required) - The IMAP port on the source server. It defaults to 993 and accepts a value from 1 to 65535.
• Encryption (required) - How the connection to the source server is secured:
  • SSL/TLS (usually port 993)
  • STARTTLS (usually port 143)
  • None
• Source username (required) - The login for the source mailbox, usually the full email address.
• Source password (required) - The password for the source mailbox.

Test the connection

Select Test connection to verify the details before you start. The panel reports one of the following results:

• Connection successful - the details are valid and the import can start.
• Connection failed - the source server rejected the connection or the credentials.
• Missing connection details - one or more required fields are empty.
• Invalid source server address - the server value is not a valid hostname or IPv4 address.

Start the import

Select Start Import to queue the transfer. The import runs on the server, not in your browser, so you can close the dialog and leave the page while it works.

The Import column on the account list reports progress and refreshes every 10 seconds while an import is running:

• Import queued - the import is waiting to start.
• Importing X/Y - messages are being copied, where X is the number processed and Y is the total.
• Imported (N) - the import finished and copied N messages.
• Import failed - the import did not complete. Hover over the status to read the error in a tooltip.

Imports are safe to re-run. Existing messages are kept, and running the import again only pulls in new messages from the source mailbox.

Note: You can run one active import per mailbox and up to three active imports per hosting account at a time. The source password is used only for the transfer and is removed once the import completes.

Getting Started

Create your first email account by clicking the "Create Email Account" button and following the provided wizard.