Installation Guide

eBox Platform Installer

The preferred way to install eBox Platform on a new machine from scratch is using our tailored CD installer. This CD contains eBox and all its dependencies. It's based on Ubuntu Server 8.04. It also preconfigures some packages in order to save time.

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

https://<ebox-ip-address>/

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 our repositories.

eBox Platform 1.4 packages

For Ubuntu 8.04 (Hardy). You should install the server editon.

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

deb http://ppa.launchpad.net/ebox/1.4/ubuntu hardy 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 342D17AC

eBox Platform 1.2 packages

For Ubuntu 8.04 (Hardy). You should install the server edition.

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

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

Installing packages

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

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

First of all, make sure that your package database is up to date by running the following command:

sudo apt-get update

You can install one or more profiles, you just need to run:

sudo apt-get install <profile-name>

Example:

sudo apt-get install ebox-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-egroupware
  • ebox-firewall
  • 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