Zentyal Installation Guide

Zentyal Installer

Zentyal Logo

The preferred way to install Zentyal (formerly eBox Platform) on a new machine from scratch is using the tailored CD installer. This CD contains Zentyal and all its dependencies. The 2.0 version is based on Ubuntu Server 10.04 and is available for 32 and 64 bit architectures.



Note: If you want to define the partition layout manually or you need to specify a proxy to get Internet access, make sure you install using the “expert mode”.

Once the installation process is done, you can access the web interface using a web browser (usually from another machine in the same network):


To log in, a user name and password is asked, this data is asked during the first stage of the installation. But any other user belonging to the “admin” group could be used to log in as well.

Notes for installation on a Virtual Machine

Note: The installers are generated from time to time, so maybe some packages contained on them are outdated. If you have Internet connection during the installation, the latest version of the packages will be installed from zentyal repositories.

Zentyal 2.0 packages

For Ubuntu 10.04 (Lucid). You should install the server edition.

Add to your /etc/apt/sources.list:

deb http://ppa.launchpad.net/zentyal/2.0/ubuntu lucid main

In order to authenticate the packages in the PPA you can import its public key with the following command:

sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 10E239FF

Read the 2.0 Announcement for more info.

Zentyal 2.1 Beta packages

For Ubuntu 10.04 (Lucid). You should install the server edition.

Add to your /etc/apt/sources.list:

deb http://ppa.launchpad.net/zentyal/2.1/ubuntu lucid main

In order to authenticate the packages in the PPA you can import its public key with the following command:

sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 10E239FF

Read the 2.1 Announcement for more info.

Installing packages

Zentyal has a modular design that allows you to install or remove modules depending on your needs. The number of Zentyal modules is greater than 30. In order to ease the process of installation you can install one or more Zentyal profiles. A profile contains a set of packages that are commonly used in a task. This is a the list of the current profiles:

  • zentyal-office: ebox-samba, ebox-printers, ebox-antivirus, ebox-ebackup, ebox-software, ebox-monitor
  • zentyal-communication: ebox-mail, ebox-jabber, ebox-asterisk, ebox-mailfilter, ebox-antivirus, ebox-ebackup, ebox-software, ebox-monitor
  • zentyal-security: ebox-firewall, ebox-ids, ebox-squid, ebox-openvpn, ebox-mailfilter, ebox-antivirus, ebox-ebackup, ebox-software, ebox-monitor
  • zentyal-gateway: ebox-network, ebox-squid, ebox-firewall, ebox-trafficshaping, ebox-l7-protocols, ebox-ebackup, ebox-software, ebox-monitor
  • zentyal-infrastructure: ebox-network, ebox-dhcp, ebox-dns, ebox-openvpn, ebox-webserver, ebox-ntp, ebox-ebackup, ebox-software, ebox-monitor, ebox-ftp

The groupware module (ebox-zarafa) needs an extra repository added in /etc/apt/sources.list:

deb http://archive.canonical.com/ubuntu lucid partner

Note that if you use our installer Zarafa is already included in the CD and it’s also included in the zentyal-office profile.

The old groupware module (ebox-egroupware) is also on a separate repository:

deb http://ppa.launchpad.net/zentyal/2.0-contrib/ubuntu lucid main

After editing your sources.list, make sure that your package database is up to date by running the following command:

sudo apt-get update

After that, you just need to run:

sudo apt-get install zentyal

And then point your browser to the Zentyal IP address and follow the instructions on screen:


You can also use the command line to install the packages.


sudo apt-get install zentyal-office

You can also install all the eBox packages:

sudo apt-get install ebox-all

In case you need just a few modules you can also install any of the following list by running apt-get install <modulename>:

  • ebox-antivirus
  • ebox-asterisk
  • ebox-ca
  • ebox-dhcp
  • ebox-dns
  • ebox-ebackup
  • ebox-firewall
  • ebox-ftp
  • ebox-ids
  • ebox-jabber
  • ebox-l7-protocols
  • ebox-mail
  • ebox-mailfilter
  • ebox-monitor
  • ebox-network
  • ebox-ntp
  • ebox-objects
  • ebox-openvpn
  • ebox-printers
  • ebox-remoteservices
  • ebox-samba
  • ebox-services
  • ebox-software
  • ebox-squid
  • ebox-trafficshaping
  • ebox-usersandgroups
  • ebox-webserver
  • ebox-radius
  • ebox-webmail
  • ebox-zarafa

The new package names from Zentyal 2.1 on are:

  • zentyal-antivirus
  • zentyal-asterisk
  • zentyal-ca
  • zentyal-dhcp
  • zentyal-dns
  • zentyal-ebackup
  • zentyal-firewall
  • zentyal-ftp
  • zentyal-ids
  • zentyal-jabber
  • zentyal-l7-protocols
  • zentyal-mail
  • zentyal-mailfilter
  • zentyal-monitor
  • zentyal-network
  • zentyal-ntp
  • zentyal-objects
  • zentyal-openvpn
  • zentyal-printers
  • zentyal-remoteservices
  • zentyal-samba
  • zentyal-services
  • zentyal-software
  • zentyal-squid
  • zentyal-trafficshaping
  • zentyal-users
  • zentyal-usercorner
  • zentyal-webserver
  • zentyal-radius
  • zentyal-webmail
  • zentyal-zarafa

Taken from: Zentyal Documentation

Zentyal – The Linux Small Business Server

For a couple of years now I’ve been deploying this solution for some clients, the former name was “Ebox Platform” but this year they decided to make the change to Zentyal, just let me tell you this is a great solution for manage domains, firewalls, vpn, proxy or email servers (among other services).

The most amazing thing is how fast you can be up and running and the maintenance is a breeze.

Of course you always can access to command line if you have to do some advanced tasks, but the web console covers most of the configuration needed for a sysadmin.

Here are some screenshoots.