Carbonio CE Installation
This page provides hardware and software requirements for Carbonio CE and directions for its installation. Please review carefully this whole page before attempting to install.
Intel/AMD 64-bit CPU 1.5 GHz
Disk space (Operating system and Carbonio CE)
Supported Virtualization Platforms
VMware vSphere 6.x
VMware vSphere 7.x
Virtualbox (testing purposes only)
Supported Linux Server Distributions
Carbonio CE is available for 64-bit CPUs only and can be installed on Ubuntu 18.04 LTS Server Edition.
Support for Redhat/CentOS and Ubuntu 20.04 LTS Server Edition will be available soon.
Required Software Packages
Besides a standard installation of the supported distribution, no software package is necessary.
The installation is organised in steps, some of which are preliminary configuration tasks, and some is optional.
Step 1: Interfaces
We suggest to set up two NICs on the server, and assigning to one a local IP address, so that Carbonio CE can always use it and rely on it even if the main, public IP address changes. This setup is also useful for testing purposes or when setting up a demo.
Example: Assign an IP Address to a local NIC.
Assuming that a NIC identified as enp0s3 is free on your system, for example in Virtualbox use a Network adapter of type Internal Network, you can assign it an IP address in the preferred way:
use the CLI, for example ifconfig enp0s3 172.16.0.10 up
Use netplan.io and add these lines to file
eth1: dhcp4: false dhcp6: false addresses: [172.16.0.10/24]
then issue the command netplan apply
Step 2: Setting Hostname
Carbonio CE needs a valid FQDN as hostname and a valid entry in the
/etc/hosts file. To configure them, execute these two commands.
first, set the hostname
# hostnamectl set-hostname mail.carbonio.local
# echo "172.16.0.10 mail.carbonio.local mail" >> /etc/hosts
Step 3: DNS Resolution
Carbonio CE needs valid DNS resolution for:
the domain (MX and A record)
the FQDN (A record)
So make sure that the DNS is correctly configured for both A and MX records.
Example: Set up of dnsmasq
As an example, we provide here directions to install and configure dnsmasq. This task is optional and suitable for demo or testing purposes only.
In case you can not rely on an existent DNS server for DNS resolution, or if you want to set up a local Carbonio CE installation for testing or demo purposes, you can install dnsmasq.
# apt install dnsmasq
To configure it, add the following lines to file
server=126.96.36.199 mx-host=carbonio.local,mail.carbonio.local,50 host-record=carbonio.local,172.16.0.10 host-record=mail.carbonio.local,172.16.0.10
Finally, restart the dnsmasq service
# systemctl restart dnsmasq
Installation and Post-Installation
Step 4: Repository Configuration and System Upgrade
In order to add Carbonio CE’s repository, go to the following page and fill in the form:
You will receive an e-mail containing:
the URL of the repository
the GPG key of the repository
Follow the instructions in the e-mail to add these data to your system, then continue with the next steps:
update the list of packages
# apt update
upgrade the system
# apt upgrade
Step 5: Installation and Configuration of Carbonio CE
Installation of Carbonio CE requires to run the command
# apt install carbonio-ce
In order to carry out the initial configuration and start Carbonio CE, execute
This command makes a few checks and then starts the installation, during which a few messages are shown, including the name of the log file that will store all messages produced during the process:
Operations logged to /tmp/zmsetup.20211014-154807.log
In case the connection is lost during the installation, it is possible to log in again and check the content of that file for information about the status of the installation. If the file does not exist anymore, the installation has already been completed and in that case the log file can be found in directory
The first part of the bootstrap enables all necessary services and creates a new administrator account (email@example.com), initially without password (see below for instruction to set it).
Before finalising the bootstrap, press y to apply the configuration. The process will continue until its completion: click Enter to continue.
create a password for the
firstname.lastname@example.org. Log in to a shell terminal as the
zextrasuser and execute these two commands. The first allows to switch to the
zextrasuser, with the second you actually change the password.
# su - zextras # zmprov setpassword email@example.com newpassword
Make sure that
newpasswordmeets good security criteria.
There is a clear distinction between these two users, which are intended to execute different tasks:
This the unix account of the administrator and must be used to carry out administrative tasks from the command line.
This is the default administrator user to be used to access the Admin UI and manage Carbonio CE from the web interface.
Installation is now complete, you can access Carbonio CE‘s graphic interface as explained in section Access to the Web Interface.
Our Community portal features a guide that delves more into details of the installation process:
Access to the Web Interface
The URL to which to connect to are: