Style Cleanup Required
This article does not follow the style standards in the Wiki Guide. More info...


This guide covers installation and configuration of eBox (currently renamed to Zentyal). Zentyal is a web framework used to manage server application configuration. The modular design of Zentyal allows you to pick and choose which services you want to configure using Zentyal.

The official Zentyal website provides directions for installing directly from their PPA. (sudo add-apt-repository ppa:zentyal/2.0) eBox version 1.5 is the development branch for use with Ubuntu 10.04 LTS (Lucid Lynx). On September 2010 it was renamed as Zentyal with the release of the 2.0 version.

Older Versions

IconsPage/warning.png WARNING: the eBox package released with Ubuntu 8.10 (Intrepid Ibex) is broken and cannot be installed. See bug #255368 for information and unsupported workarounds.

IconsPage/warning.png WARNING: the eBox version released with Ubuntu 7.10 (Gutsy Gibbon) has several bugs that severely limit its usefulness. The eBox version released for Ubuntu 8.04 (Hardy Heron) is much more functional.


The ebox package can be installed from the Universe repository. See InstallingSoftware for detailed instructions using package managers. The different eBox modules are split into different packages, allowing you to only install those necessary. One way to view the available packages is, from a terminal enter:

apt-cache rdepends ebox | uniq

You can install all eBox packages by running:

sudo apt-get install “^ebox-.*” 

During the installation you will be asked to supply a password for the ebox user. After installing eBox the web interface can be accessed from: https://yourserver/ebox.

Using the latest version

To install a newer version of eBox or Zentyal than is included in Ubuntu's repositories add to the file /etc/apt/sources.list this line if you are using Ubuntu 8.04 (Hardy Heron):

deb http://ppa.launchpad.net/ebox/1.4/ubuntu hardy main 

Or this one if you are using Ubuntu 10.04 (Lucid Lynx):

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

Be sure to run

sudo apt-get update

before installing it.

eBox Configuration

An important thing to remember when using eBox is that when configuring most modules there is a Change button that implements the new configuration. After clicking the change button most, but not all, modules will then need to be Saved. To save the new configuration click on the Save changes link in the top right hand corner. Once you make a change that requires a save the link will change from green to red.

eBox Modules

By default all eBox Modules are not enabled, and when a new module is installed it will not be automatically enabled.

To enable a disabled module click on the Module status link in the left had menu. Then check which modules you would like to enable and click the Save link.

Default Modules

This section provides a quick summary of the default eBox modules.

  • System: contains options allowing configuration of general eBox items.

    • General: allows you to set the eBox language and port number. Also, contains a change password form.

    • Disk Usage: presents a graph detailing information about disk usage.

    • Backup: is used to backup eBox configuration information, and the Full Backup option allows you to save all eBox information not included in the Configuration option such as log files.

    • Halt/Reboot: will shutdown the system or reboot it.

    • Bug Report: creates a file containing details helpful when reporting bugs to the eBox developers.

  • Logs: allows eBox logs to be queried depending on the purge time configured.

  • Events: this module has the ability to send alerts through rss, jabber, and log file.

    • Events:
      • Free Storage Space: will send alert if free disk space drops below a configured percentage, 10% by default.

      • Log Observer: unfortunately this event doesn't work with the eBox version shipped with Hardy.

      • RAID: will monitor the RAID system and send alerts if any issues arise.

      • Service: sends alerts if a service restarts multiple times in a short time period.

      • State: alerts on the state of eBox, either up or down.

    • Dispatchers:
      • Log: this dispatcher will send event messages to the eBox log file /var/log/ebox/ebox.log

      • Jabber: before enabling this dispatcher you must first configure it by clicking on the configure icon.

      • RSS: once this dispatcher is configured you can subscribe to the link in order to view event alerts.

Expansion Modules

  • Network: allows configuration of the systems network options through eBox.

  • Firewall: configures firewall options for the eBox host.

  • UsersandGroups: this module will manage users and groups contained in an OpenLDAP LDAP directory.

  • DHCP: provides an interface to configuring a DHCP server.

  • DNS: provides BIND configuration options.

  • Objects: allow configuration of eBox Network Objects, which allow you to assign a name to an IP or group of IPs.

  • Services: displays configuration information for services that available to the network.

  • Squid: configuration options for the Squid proxy server.

  • CA: configures a Certificate Authority for the server.

  • NTP: set Network Time Protocol options.

  • Printers: interface allowing the configuration of printers.

  • Samba: configuration options for Samba.

  • OpenVPN: setup options for OpenVPN Virtual Private Network application.

Connecting Services to ebox


eBox (last edited 2011-04-04 16:59:50 by cpe-76-94-215-209)