Mesh and Directory#

Install Packages#

# apt install service-discover-server carbonio-directory-server
# dnf install service-discover-server carbonio-directory-server


Unlike other client-server software (like e.g., PostgreSQL), the service-discover software on which Carbonio is based does not require the agent to be installed along the server, therefore the service-discover-agent package is needed only in the other nodes.

Bootstrap Carbonio#


# carbonio-bootstrap

The bootstrap command will execute a number of tasks and will set up the node. At the end, you will be prompted with a menu and, if you already configured all, you only need to click y for confirmation.

On RHEL 9 only, restart the node to ensure that Carbonio service management come under the control of systemd:

# reboot

Set up Carbonio Mesh#

Carbonio Mesh is required to allow communication between Carbonio and its components. The configuration is interactively generated by command

# service-discover setup-wizard

This command will:

  • ask for the IP address and netmask

  • ask for the Carbonio Mesh secret, which is used for setups, management, and to access the administration GUI. See section Carbonio Mesh Administration Interface for more information.

    This password will be denoted as MESH_SECRET throughout the documentation.


    We suggest to use a robust password which is at least 16 characters long, including at least one of lowercase and uppercase letters, numbers, special characters and store it in a password manager.

    In case the password is lost or the credential file becomes corrupted and unusable, you can reset them using the procedure detailed in section Carbonio Mesh Credentials.

  • store the setup in file /etc/zextras/service-discover/cluster-credentials.tar.gpg

To complete Carbonio Mesh installation, run

# pending-setups -a


The secret is stored in file /var/lib/service-discover/password, which is accessible only by the root user.

Retrieve the LDAP Admin Password#

Once the installation of this role is complete, you will be able to obtain the password by running the following command:

# su - zextras -c "zmlocalconfig -s | grep ldap_password"

The password thus obtained will be necessary to install all other roles.