Access to the Web Interface

The first task to carry out is to change the password of the zextras user. This is a very important task, because this user has full powers over all Carbonio functionalities, therefore its password must be robust. More details and the command to change the password can be found in section Manage Global Administrators.

After you change the password, point a supported browser to the Proxy Node’s IP or hostname and port 6071 (e.g., https://172.16.0.12:6071/) and log in to the Carbonio Admin Panel , with user zextras@example.com and password the one you just changed.

If the login is successful, go to Domains, select the domain example.com, and, under the General Settings and define:

• The Public Server Host Name, setting it as https://mail.example.com

• The Public Service Port, setting it as 443.

These two values combined represent the URL that users need to access to use the features of Carbonio.

Note

Since Carbonio uses SSL, it is strongly suggested to install an SSL certificate. Please refer to Section Deploy an SSL Certificate (CLI) or Virtual Hosts & Certificate Carbonio Admin Panel for directions. you can even install a Let’s Encrypt certificate.

Web Client

The web client is used for regular access to the e-mail account and can be used also to access other functionalities (Carbonio Files, Carbonio Docs if installed), as well as other client protocols such as IMAP or POP, and is available at https://mail.example.com/. In Carbonio User Guides you can find directions that guide you in your first steps with Carbonio and introduction to the most common tasks

Carbonio Admin Panel

The Carbonio Admin Panel is used for Administration access and is available at: https://mail.example.com:6071/

Here, you can manage server, domains, accounts, and other configurations. Please refer to section Carbonio Admin Panel Overview for more information.

Multiple Configured Domains

When multiple domains are defined on Carbonio, you will see in the username field, the default domain: to log in to that domain, you can use only the username. To login to another domain, you need to write the whole e-mail address: username and domain.

Lost Password

If the Administrator has enabled the option, you can see a link underneath the credential’s text-fields, that allows you to recover the password. Before you use it, however, you need to ask the Administrator to set up a recovery account.

Manage Global Administrators

In order to change the password used by the zextras@example.com user for the Web access, log in to a shell terminal as the zextras user and execute the command

# su - zextras -c "carbonio prov setpassword zextras@example.com mynewsecurepassword"

Make sure that newpassword meets good security criteria.

The zextras and zextras@example.com users

There is a clear distinction between these two users, which are intended to execute different tasks:

zextras

This the unix account of the administrator and must be used to carry out administrative tasks from the command line.

zextras@example.com

This is the default administrator user to be used to access the Admin UI and manage Carbonio from the web interface.

A new Global Admin can be created from the Carbonio Admin Panel; please refer to section Create New Global Admin for directions.