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.

System Requirements

Hardware requirements

CPU

Intel/AMD 64-bit CPU 1.5 GHz

RAM

8 Gb

Disk space (Operating system and Carbonio CE)

40 Gb

Supported Virtualization Platforms

VMware vSphere 6.x

VMware vSphere 7.x

XenServer

KVM

Virtualbox (testing purposes only)

Software Requirements

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.

Installation

The installation is organised in steps, some of which are preliminary configuration tasks, and some is optional.

Pre-Installation Steps

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 /etc/netplan/01-netcfg.yaml:

    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.

  1. first, set the hostname

    # hostnamectl set-hostname mail.carbonio.local
    
  2. then update /etc/hosts

    # 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 /etc/dnsmasq.conf:

server=1.1.1.1
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

  1. In order to add Carbonio CE’s repository, go to the following page and fill in the form:

    https://www.zextras.com/carbonio-community-edition/#discoverproduct

    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:

  2. update the list of packages

    # apt update
    
  3. upgrade the system

    # apt upgrade
    

Step 5: Installation and Configuration of Carbonio CE

  1. Installation of Carbonio CE requires to run the command

    # apt install carbonio-ce
    
  2. In order to carry out the initial configuration and start Carbonio CE, execute

    # carbonio-bootstrap
    
    What does carbonio-bootstrap do?

    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 /opt/zextras/log.

    The first part of the bootstrap enables all necessary services and creates a new administrator account (zextras@carbonio.local), 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.

  3. create a password for the zextras@carbonio.local user. Log in to a shell terminal as the zextras user and execute these two commands. The first allows to switch to the zextras user, with the second you actually change the password.

    # su - zextras
    # zmprov setpassword zextras@carbonio.local newpassword
    

    Make sure that newpassword meets good security criteria.

    The zextras and zextras@carbonio.local 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@carbonio.local

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

Installation Complete

Installation is now complete, you can access Carbonio CE‘s graphic interface as explained in section Access to the Web Interface.

See also

Our Community portal features a guide that delves more into details of the installation process:

https://community.zextras.com/how-to-deploy-a-private-e-mail-server-for-free-using-zextras-carbonio-ce/

Access to the Web Interface

The URL to which to connect to are: