Domains
The Domain page allows the management of domains and of related settings, including individual accounts, user quota and authentication, mailing lists, and more.
The following sections are available in the page: global settings, domain details, and domain management.
Create New Domain
To create a new domain, fill in the form that opens upon clicking the CREATE button.
acme.example
Two types of options are available during the creation of a new domain:
-
General information
The only mandatory data to supply it the domain name, which is its FQDN. All other data are optional and can be set at a later point.
Important options that can be configured during the domain creation are the total number of accounts that can be managed for the domain and the e-mail quota. Also a description can be added.
-
GAL settings
Except for the GAL mode, currently only Internal, it is possible to define the account used to synchronise GAL information, the mail server used, which must be on the same domain (or in a compatible one, i.e., in a valid alias URL, see section Virtual Hosts & Certificate below).
The image below shows how a sample domain is created.

Further configuration option for the domain, including how to configure authentication and accounts in the domain, can be found in the Domain Details section.
Global
Theme
Global settings concern the appearance of Carbonio and allow to customise various option that will influence how the Carbonio web interface appears to the web clients.
Note
These setting are applied to all the domains configured; if you want to customise the appearance, please change the settings under
.All the resources used for White Labelling must have a valid URI and must be reachable from Carbonio.
In case the resources are hosted on an server external to the Carbonio infrastructure, make sure that server’s SSL certificate is valid and has not expired, and its FQDN is valid and resolvable from Carbonio (from the Proxy Node in case of a Multi-Server).
You can safely use the Carbonio’s Proxy Node to expose those
resources, by uploading them into a directory called for example
/opt/zextras/web/custom/
(create it if does not exist yet) and
using the URL https://<Carbonio_hostname>/static/custom/
, where
<Carbonio_hostname>
is the FQDN of the Single-Server or of the
Proxy Node in a Multi-Server.
Moreover, in a Multi-Server featuring multiple Proxy Nodes, it is mandatory to keep in sync the resources on all the Proxies instances.
The light mode features a white-based colour combination for the Carbonio login page and GUI, while the dark mode has a black-based colour combination.
Select the primary colour that will used in either Light or Dark mode, using an HEX (HTML) value. The secondary colour will be automatically computed.
The title is the string that will appear on the client’s tab, while the copyrights information will appear at the bottom of the panel in the login page.
This is the logo that appears on the login mask of Carbonio at the top of the panel in the login page. There are different dimensions and ratios for the Admin and End User logos.
Requirements:
Each login logo must adhere to the following suggested requirements.
The preferred format is SVG
The logo must have a transparent background
-
For a correct display of the logos, please respect the aspect ratio indicated and (in the case of raster images) respect dimensions as close as possible to the default ones
Admin: ratio 7:1, default 340x47 pixel
End user: ratio 4:1, default 340x85 pixel
This logo appears:
on the main page after a successful login, is displayed on the upper left corner.
in video calls: before starting and after terminating the call and during the call, in the top right corner
There are different dimensions and ratios for the Admin and End User logos.
Requirements:
Each WebUiApp logo must adhere to the following suggested requirements.
The preferred format is SVG
The logo must have a transparent background
-
For a correct display of the logos, please respect the aspect ratio indicated and (in the case of raster images) respect dimensions as close as possible to the default ones
Admin: ratio 5:1, default 150x30 pixel
End user: ratio 8:1, default 250x31 pixel
The favicon will be displayed next to the tab’s name and in browser notifications, if they have been activated in your browser.
Requirements:
The favicon must adhere to the following maximum requirements.
The format must be ICO
The dimensions must be 64x64 pixel, with ratio 1:1 (i.e., it must be square)
The background image for the login page is displayed behind the login panel during the login phase, You can choose one image for the light mode and one for the dark mode.
Requirements:
The images used for the background must adhere to the following maximum requirements.
The format must be JPG
The dimensions must be at least 1920x1050 pixel, with ratio 16:9
The size must be 800 Kb
All customisations can be removed at once by clicking the RESET button.
This URL is shown whenever a user logs out from Carbonio by clicking on the Logout item in the menu appearing when clicking on the account icon on the top-right corner.
It can currently be configured from the CLI only, using command
zextras$ carbonio prov mcf zimbraWebClientLogoutURL "https://example.com/"
2-Factor-Autentication
In this page it is possible to configure 2FA globally (i.e., for all domains configured) for the various services offered by Carbonio. To modify settings for a single domain, refer to 2-Factor-Autentication.
Note
The global values configured are inherited by all domains, unless they are overridden in the domain.
Many services are available to configure individually. For each of them it is possible to Disable 2FA completely, allowing user access with username and password only; to Trust the IP, meaning that all client connections from a given IP address or IP range will be trusted even if they don’t use 2FA; and to Trust the device which allows an application (usually a browser) to be trusted when connecting from a given IP.
Hint
2FA applies only to those protocols or apps supporting it, for example HTTP and HTTPS but not to IMAP and SMTP.
Domain Details
In the various subsection present in Domain Details, it is possible to refine the configuration of the domain. Values for most of the options (for example the Time Zone), if not specified for a given domain, are inherited from the main domain defined.
General Settings
General setting influence the basic domain configuration; most of them
appear during the creation of the domain. Additional options allow to define the time zone,
the use of HTTP
or HTTPS
protocol (we suggest using always the
latter), and a mail server used for spam-relay purposes.
Moreover, a default COS and its status can be attached to the domain.
A COS can be defined for a whole domain or an account and determines its status, that is, its ability to log in to the domain and access the e-mail. If the domain COS and a user’s COS differ, the resulting status of the account is shown. Each COS can be defined with one of the following five values.
Active. The COS is enabled, therefore the domain and its accounts can be used for everyday operations.
-
Closed. The domain is shut down, no access is granted, and all incoming e-mails are rejected.
Hint
This status overrides the individual accounts COS status.
Locked. In this state, user access is not possible, unless individual accounts are marked as Active. Incoming e-mails are regularly delivered to the accounts.
Maintenance. Users can not log in, their incoming e-mails are not delivered but are kept in a queue by the MTA. If the account’s status is closed, it overrides the domain status setting, that is, the user’s incoming e-mails are rejected.
Suspended. A status similar to maintenance, with the difference that no accounts or distribution lists can be changed. If the account’s status is closed, it overrides the domain status setting, that is, the user’s incoming e-mails are rejected.
We build on the domain created in previous section and attach some property.
Force clients to connect only using https
.
It is the FQDN (mail.acme.example
) used by clients to
connect to the domain and must correspond to the DNS A
record to be reachable publicly. If the A
record is set to a
private IP address, to reach the WebGUI you need some mechanism,
like e.g., a VPN tunnel.
The timezone is set to Hawaii’s time.
The COS used by the domain, which is left to the default
one.
At the bottom of the page, button DELETE DOMAIN allows to delete the domain. When clicked, a dialog will open, listing all items defined on the domain (Accounts, mailing lists, resources, and so on) and that will be deleted together with the domain. Two choices are available: to Close the domain, keeping all items but preventing access, or Remove the domain and all its items.
Warning
The removal of the domain is an operation that can not be undone: all the items are gone forever.
Global Access List
A GAL is a special account (“GALSync Account”) that contains all e-mail accounts configured on the server and provides the ability to quickly search e-mail addresses, for example when composing an email or adding participants to an event in the Calendar. A GAL can be internal when configured on Carbonio, external (when configured on the LDAP used by Carbonio, or both. In this page you see the email-address of the GALSync account, you can change it from external to internal, or vice versa, or both. you can also remove it, create it if missing, and change some of its options.
The GALSync account is updated regularly, according to the interval specified in the Settings section of the page. Administrators can force a resynchronisation of all GALs defined on a domain by clicking the RE-SYNC button.
Virtual Hosts & Certificate
A Virtual Host is an alternative name given to a domain that can
be used to access the same domain. To be able to use the virtual host,
the name must be registered on the domain’s DNS with an A
record. Users can then log in to the domain using only their
usernames, without the domain.
To each virtual host you can associate an SSL certificate. Carbonio supports the upload of multiple SSL domain certificates from the Carbonio Admin Panel and associate them to different domains, a procedure that requires only a few steps.
Note
The generation of server-side certificates directly on Carbonio and the management of wildcard certificate are tasks that can be carried out from the CLI only: check out section Deploy an SSL Certificate if you need to use either of them.
Select the virtual host, then click UPLOAD AND VERIFY CERTIFICATE. In the dialog, you can choose to use:
A Let’s Encrypt longChain Certificate, i.e., including an intermediate certificate. Make sure to satisfy the requirements before clicking the GENERATE CERTIFICATE button. Complete the procedure according to the directions below.
-
A Let’s Encrypt shortChain Certificate, without intermediate certificate: like the previous case, make sure to satisfy the requirements before clicking the GENERATE CERTIFICATE button. Complete the procedure according to the directions below.
Let’s Encrypt’s Short and Long Chain certificates.Without going into much details, the difference between the two types of certificates issued by Let’s Encrypt (“ISRG Root X1”) is the compatibility with older Android clients and SSL libraries.
More technically, the difference is that the Short Chain contains two certificates: Let’s Encrypt’s Root certificate and the one issued to your website, signed by the former; while the Long Chain three: the same of the Short Chain and an intermediate certificate. The ISRG Root X1 indeed, was issued quite recently and may not be known to some browsers, devices, or clients, therefore it was decided to add as intermediate certificate another root certificate that is well known to clients, to expand compatibility.
See also
More details and technicalities about the Short vs. Long Chain certificates can be found in article Long (default) and Short (alternate) Certificate Chains Explained.
A custom certificate. In this case, you need to provide by yourself the three files of the authorisation chain (i.e., the Domain Certificate, the Certificate CA Chain, and the Private Key) in the first or copy the content of the individual files in the appropriate fields. Click VERIFY to verify the certificates: if everything is correct, notification The certificate is valid will appear. To use the certificate, click the I WANT TO USE THIS CERTIFICATE button to upload and use the certificate. Again, a notification will be shown (The certificates have been saved). To complete the procedure: if you are on a Single-Node, restart it otherwise you need to restart the node on which the Proxy is installed.
You can REMOVE or DOWNLOAD the certificates by clicking the appropriate button above the certificates themselves.
Procedure to install a Let’s Encrypt certificate
Before attempting to ask for a Let’s Encrypt certificate, make sure that:
Public Service Protocol and Public Service Host Name are correctly set in the Carbonio Admin Panel’s
There is a Virtual Host correctly configured for the domain you want the certificate
A, AAAA, and CNAME record in the domain’s DNS configuration
The domain has a valid FQDN that can be resolved from anywhere (i.e., the domain must be publicly accessible)
The Proxy Node is reachable from the Internet on port 80 (http). In case the proxy can not be directly reached, you must add some forwarding rules.
(Optional) To receive e-mail responses from Let’s Encrypt, Carbonio attributes
carbonioNotificationRecipients
andcarbonioNotificationFrom
are defined at global level.
To correctly issue a Let’s Encrypt certificate for your Carbonio installation, you should carry out the following steps.
The starting point is to generate the certificate using the Carbonio Admin Panel button, as shown in the previous section. besides the message on the bottom right corner, you will receive in a few minutes an e-mail, provided you set Carbonio attributes, see list above, stating the success or failure of the certificate’s generation.
Hint
You can follow the process by checking the log file
/var/log/carbonio/letsencrypt/letsencrypt.log
on the Proxy
Node, using the tail -f command from the CLI.
In case of failure, the e-mail will report the errors encountered that you need to fix before attempting again. Take into account that if you continuously ask for a certificate without success, you can be temporarily be prevented to ask again.
The message Successfully received certificate appears in the e-mail when the issue is successful, together with other information, including the expiry date, followed by a second confirmatory e-mail.
At this point you can deploy the certificate on your
infrastructure. Log in to the CLI and issue, as the zextras user
, the
commands
zextras$ /opt/zextras/libexec/zmproxyconfgen
zextras$ /opt/zextras/bin/zmproxyctl reload
The certificate expires after 90 days, and, according to Let’s Encrypt recommendations should to be renewed 30 days before expiration. You can do so manually using certbot renew from the CLI or, if you are confident, routinely from the crontab.
Once done, run again the two deployment commands
zextras$ /opt/zextras/libexec/zmproxyconfgen
zextras$ /opt/zextras/bin/zmproxyctl reload
Mailbox Quota
These settings allow to define a maximum limit (in bytes, with 0 meaning no limit) for the space used by each account and by the entire domain. It is also possible to set a value that, when reached, will send a warning by e-mail to a given address. The values configured here are inherited by all accounts that will be created, but can be overridden on a per-user basis.
To ease monitoring user’s quota, the bottom of the page contains a list of accounts and of their used quota.
Theme
These setting are the same that appear in the Global Theme section, but are domain-specific: if not defined at domain level, the global theme settings will be applied.
2-Factor-Autentication
In this page it is possible to configure 2FA for the various services offered by Carbonio, only for the selected domain. To modify settings for all domains, refer to 2-Factor-Autentication.
Many services are available to configure individually. For each of them it is possible to Disable 2FA completely, allowing user access with username and password only; to Trust the IP, meaning that all client connections from a given IP address or IP range will be trusted even if they don’t use 2FA; and to Trust the device which allows an application (usually a browser) to be trusted when connecting from a given IP.
Hint
2FA applies only to those protocols or apps supporting it, for example HTTP and HTTPS but not to IMAP and SMTP.
SAML
The management of SAML access to Carbonio is carried out from this page.
See also
The same SAML configuration tasks can be carried out from the CLI, please refer to Section Setting up SAML Configuration.
At the top of the page, two buttons allow to copy the ENTITY ID and SERVICE URL of the current Carbonio, which are required to carry out the configuration on the SAML IDP provider’s side: click each of them to paste the respective value and generate the configuration.
Once the configuration has been carried out, it is possible to copy its URL and paste it in the textfield. Click the Allow Unsecure if the configuration URL uses HTTP and not HTTPS. Click IMPORT to import the configuration.
The three button below allow to generate the SP certificate to configure the logout from the IDP and to export or delete the current configuration.
The procedure to follow for the complete logout from the IDP is described in detail in the CLI Section Configure SAML Logout. You can accomplish the same goal from the Carbonio Admin Panel by writing in the two bottom textfields the variables mentioned in that section and their corresponding value, then clicking the ADD button. Remember also to add the SP certificate to the IDP’s configuration.
Manage Domains
The Manage Domains page contains options to configure accounts, mailing, and generic resources.
Accounts
The list of all account in the domain is present here, along with information on their type and status.
The list can be filtered using the text field above the list, while a new account can be created using the + button.
A click on any account will open a new panel that contains a number of information and options, including the name and aliases, if present, its status (see below), and creation date. The aliases can be easily managed by clicking the MANAGE ALIAS button: in the opening dialog window, select a domain and a new alias, then click + to add the alias to the user.
On the panel’s top right corner, buttons allow to edit or delete the user, and also to redirect to the user’s mailbox.
When editing a user’s account, most of the option are the same that can be found in the Create New Account section and are organised in tabs. Options defined in the user’s COS are inherited, but can be modified for any individual user.
Note
The values that have been modified are accompanied by a circular arrow icon. If you hover on that icon, you will see the inherited value, while if you click on it you will restore the COS value.
This tab contains all the options provided during the account creation, plus other options, including:
The ability to prevent the user from changing the password
To remove the user’s password from LDAP
The Mailing list memberships
To move a user to another domain, which must be defined on the same server, by writing the new one in the Domain Name
Note
An Admin can not change the password of a user, only wipe it, so the user is forced to change it on the next login attempt.
Data in this tab represent the user’s phones, company, and address. They can be managed by both the user and the Administrators.
The options listed here allows to specify forwarding addresses, to prevent e-mail messages to be saved locally, and to enable ActiveSync, if these operations are allowed by the administrator. Values for these options can be set from the CLI: please refer to section Setting Features from CLI for more information.
The preferences in this tab concern how a user sees or interacts with the e-mails (receive, sending, composing, adding a signature) and are mostly inherited from the COS.
Options present here allow to manage the account security: OTP and policies for password and failed login. New application passwords and OTP tokens can be created to allow the user to login by using a QR Code; a policy can set to force the user to select a secure password and the type of characters to be chosen. The Failed login policy determines how the system behaves when a user fails too many consecutive logins.
In this tab it is possible to define for which other accounts or groups this account is responsible and which permissions (“Rights”) are granted. The first setting allow to define whether to save or not a copy of the sent messages and where: only in delegated account’s folder or also in the delegate’s folder.
The bottom part of the tab can be seen as either a Simplified View or and Advances View and allows to define permissions of the delegated people. There are small differences in the two views, the most relevant is how to set the permission.
Hint
Details on the rights that can be granted can be found in the box below.
In the Simplified View, select a user or group, then the permission and click the ADD THE ACCOUNT button to add it as a delegate. The delegated accounts will appear at the bottom of the tab.
In the Advanced View, a three steps procedure (SELECT MODE, SET RIGHTS, and ADD) guides you to complete the same task. The last step, similarly to the other guided procedures in the Carbonio Admin Panel, allows to review the settings before saving them.
Note
The user who delegates and the user who is the delegated can not share the same account; in other words, it is not possible to add as a delegated user the same account of the user who is delegating.
The Rights that can be granted to a user are basically to read, write, and send emails, and to access e-mails folders. Rights can be granted when editing an account, in the dedicated Delegates tab. Rights can be granted using a Simplified or an Advanced method.
The Simplified method permissions are granted using checkboxes:
read, access with no permission to change
read/write, full read and write permission
send, the recipient will see as sender the selected user
send on behalf, similar to the previous. the recipient will see the the sender’s e-mail preceded by the string On behalf of
In the Advanced method, rights are given in a slight different way and can be defined in a more granular way. In the SET RIGHTS step it is possible to grant the following rights: Send Mails only, Read Mails only, Send and Read Mails, Manage and Send, Read, and Manage Mails (all of the above). Depending on the choice, the bottom part will show additional options, according to the following table.
Option |
Additional options |
Send Mails only |
Send, Send on Behalf of |
Read Mails only |
folders to share |
Send and Read Mails |
Send, Send on Behalf of; folders to share |
Manage |
Folders to share |
Send, Read, and Manage Mails |
Send, Send on Behalf of; folders to share |
At the bottom of the panel, a list of the active sessions appears: for example, if a user has logged in from three different devices and never logged out, three sessions will appear. When selecting one of them, clicking the END SESSION button will close that session.
Create New Account
In order to create a new account, click the + button: a dialog window opens and allows you to set up the basic configuration of the new account.
We create the first account for the CEO of ACME Corporation and provide the following data.
-
Name, Middle Name Initials, and Surname will be used to define the user name. We use only Name (John) and Surname (Smith), which result in the JohnSmith username.
Hint
You can change the automatically generated username at will, for example to match company policies.
Password is the one used by John for the first login only
User will change password on the next login requires that John, after the first log in (and before accessing his mailbox) must change the password.
We also explicitly configure the Account Status (see the list of possible values), but do not change the Default COS. Click the CREATE WITH THESE DATA button to create the account
Note
When assigning a COS to a user, all the values defined in that COS will be inherited by the user. They can be later changed on a user basis later, when editing the account.

A user account can be in one of the following statuses.
Active. The account is enabled and ready for everyday operations: the user can log in and send and receive e-mails.
Under Maintenance. This state occurs during maintenance operations on the domain or account: backup, import, export, restore. The user can not login, e-mails are queued on the MTA.
Locked. The account can not be accessed by the user, but incoming e-mails are still delivered. This status can be set for example if the user violates the terms of service or if the account has been cracked
Closed. The user is not allowed to log in, incoming e-mails are rejected.
Pending. This status is usually seen during the account creation, when it is not yet active. User can not log in, incoming e-mails are rejected.
-
LockOut. This is the only status that can not be set. It is applied automatically when the log in attempts fail for a given number of times. It is a preventive measure to avoid unauthorised access of brute force attacks. The account will not be accessible for a given interval (“lockout period”)
Hint
Both the number of failed attempts and the lockout period can be configured.
Create New Global Admin
To create a new Admin, you need first to create the account, as explained in the previous section. We give this account the acme_admin name.
Then, from the account list, select the new account, then click the pencil icon to edit it.

Fig. 4 Create a new Global Admin.
To make acme_admin a Global Admin, in the General tab go to Settings and click the switch with label This is a Global Administrator, then save. The acme_admin user is now able to access the Carbonio Admin Panel.
Mailing List
Mailing list can be simply created by clicking the + button to open a tabbed modal dialog in which to configure the mailing list.
In the first tab you can give a name, an address, and a description to the mailing list; in the second add Members by simply writing the e-mail addresses in the test field.
Hint
E-mail addresses are auto-completed while typing.
In the third tab, advanced settings can be configured, including to limit the members that are allowed to send e-mails to the list, the policies for subscription and unsubscription requests, and the owners of the mailing list,
The last tab recaps the settings: now you can wither go back to any of the previous tabs and change some of the settings, or proceed to create the mailing list.
Once a mailing list has been created, it can be further configured by adding aliases, which work like e-mail accounts, changing the members and owners, and granting selected users the permission to send e-mails to the mailing list.
Dynamic Mode
Mailing list’s Dynamic Mode allows the automatic management of members. Indeed, each Dynamic Mailing List is identified by a name and by a unique Mailing List URL, which is an LDAP query that automatically populates the members of the Mailing List.
To create a Dynamic Mailing List, the procedure is similar to the normal Mailing Lists: click the + button and provide a Displayed Name name and list Name, then click the Dynamyc Mode switch to access more options, including the Mailing List URL, which is mandatory. You can also make the list Hidden from GAL and add owners to the list, who can manage the configuration of the list.
Advanced options, like subscription and unsubscription options are available after the creation of the Dynamic Mailing List, when editing it.
ActiveSync
This page gives information about all accounts connected using the ActiveSync protocol. For each connected device, some information is shown, including its unique Device ID and the time when it last connected. Clicking any of the connections will show additional information, including client data and the device’s ABQ status (see ABQ - Allow/Block/Quarantine device control)
The following actions can be carried out: WIPE DEVICE (bring the connected device back to factory settings), to RESET DEVICE (log out the device from the account), and SUSPEND the connection.
Restore Account
The Restore Account procedure allows you to restore the contents and preferences of a mailbox in the exact status when it was deleted.
When a Restore Account starts, a new account is created (the Destination Account), and all the items existing in the source account at the moment of the deletion are recreated in the destination account, including the folder structure and all the user’s data. All restored items will be created in the current primary store unless the Apply HSM Policy after the restore box is checked.
Warning
When restoring data on a new account, shared items consistency is not preserved. This is because the original share rules refer to the original account’s UUID, not to the Destination Account, which has a completely different UUID.
To start the procedure, type an e-mail address in the text-field or select an account from the list.
Then, click on the CONFIG tab and select the options to apply for the Restore:
To which date and time to restore the account
Whether to use the last available status of the account
If External Data Sources should be restored
-
Select an e-mail to which send a notification of the successful restore.
Hint
This could be the alternate e-mail of the user whose account is being restored.