Installing on Debian or Ubuntu

From Group-Office Groupware and CRM Documentation
Jump to: navigation, search

The main package

This is the easiest way of installing Group-Office. With the Debian packages everything is configured automatically and Group-Office updates will be installed automatically when you update your Debian or Ubuntu system.

Install Debian >= 5 or Ubuntu >=8.10

Note: All the commands here use "sudo". This is necessary on Ubuntu. If you are on Debian you can use the "su" command first and execute all the commands without "sudo".

Add the following line to /etc/apt/sources.list

deb sixone main

You can do that easily by executing the following command in the terminal:

echo -e "\n## Group-Office repository\ndeb sixone main" | sudo tee -a /etc/apt/sources.list

To authenticate the packages you need to import the public key by running the following commands: In Ubuntu don't do this as root because you will have trouble with the gpg keyring permissions. On Debian you can do this as root and omit the sudo command before the apt-key add command.

gpg --keyserver hkp:// --recv-keys 01F1AE44
gpg --export --armor 01F1AE44 | sudo apt-key add -

Note: The keyservers are often very slow. If the keyserver doesn't respond you may try this one instead: hkp://

Open a terminal and become root. On Debian you must execute the command "su" and on Ubuntu you must execute the command "sudo -s" to become root.

sudo apt-get update
sudo apt-get install groupoffice-com

This will install groupoffice on http://yourhostname/groupoffice/. If you want to change the location read Moving Group-Office from it's default location

Note: It could be possible that you get a blank screen when you go to the Group-Office url. Most of the time this is caused with wrong rights on the "/home/groupoffice" folder. Please make sure that the webserver is able to read and write in these folder and it's subfolders.

Complete mailserver solution

Warning: If you install groupoffice-mailserver it will reconfigure the entire mail system. Use only on a fresh Debian or Ubuntu installation without a mailserver configuration. Basic knowledge of Postfix, Dovecot and SMTP is required. If you're uncertain you can purchase installation support from us.

Install it with the following command:

sudo apt-get install groupoffice-mailserver postfix postfix-mysql dovecot-mysql dovecot-sieve dovecot-managesieved

Smart host for SMTP

If you've put Group-Office into your existing network it's probably a good idea to send mail through your existing SMTP server. Edit /etc/postfix/ and set:

Connecting an external mail client

If Group-Office is configured with it's default mailserver configuration you can connect any IMAP client with these settings:

Encryption: SSL
Protocol IMAP
Port: 993
Username: (Full e-mail address and not the Group-Office username) Password: *****

SMTP authentication is not enabled by default. If you'd like to enable it please read Mailserver#Enabling_TLS_and_SMTP_authentication

Connected mail domains

When the mailserver package is installed it asks for a mail domain. This domain is entered in \$config['serverclient_domain']=''; If you'd like to add more you can simply enter them there in a comma separated list. eg. \$config['serverclient_domain']=',';

The domains listed here are presented in the new user dialog so you can automatically create mailboxes for new Group-Office users. Also the passwords will stay in sync. Read more about the serverclient.


Watch this on video to see how it's done:

Professional version

Debian 8 / Ubuntu 15.04

Create a file "ioncube.ini" in "/etc/php5/mods-available/"

; priority=00

**Please note that <PHP-Version> only needs to be the Major.Minor version. So for example it needs to be: 5.6 for PHP version 5.6.17 (The full line will then be: zend_extension=/usr/local/ioncube/

Then on command line just use

php5enmod ioncube

This creates a symlink "00-ioncube.ini" in both folders


and you are ready to go.

Older systems

To install the professional version you'll need a license from Intermesh. Ioncube needs to be installed too.

If you've installed the groupoffice-com debian package you can run:


Restart apache with:

service apache2 restart

Or you can do it manually:

  1. Look up the download link at Right click on the download link and select copy link location.
  2. Go to your server terminal and do (The examples here are for the Linux x86 architecture. your filenames might be different):
sudo -s
cd /usr/local
wget <url from ioncube>/ioncube_loaders_xxx.tar.gz
tar zxf ioncube_loaders_xxx.tar.gz
rm ioncube_loaders_lin_xxx.tar.gz

Now create /etc/php5/conf.d/ioncube.ini and add this line:

Note: Don't forget to replace the file with the correct version.


or execute:

echo -e "\nzend_extension=/usr/local/ioncube/" | sudo tee -a /etc/php5/conf.d/ioncube.ini

php -v should show something like this now:

Zend Engine v2.2.0, Copyright (c) 1998-2007 Zend Technologies
    with the ionCube PHP Loader v3.3.1, Copyright (c) 2002-2009, by ionCube Ltd., and

Note: It can happen that Ioncube is not installed for the PHP CLI Interpreter after this. A fix for it will be to run the following command on Debian/Ubuntu systems:

cp /etc/php5/apache2/conf.d/00-ioncube.ini /etc/php5/cli/conf.d/

This will add the Ioncube configuration also to the CLI interpreter.

Now restart apache and your system is ready to run Group-Office professional. The existing installation can easily be upgraded. Use the instuctions from Intermesh when you purchase the professional version to install it.

Note: If you use groupoffice-mailserver and you have a license for for example. You must change the $config['serverclient_server_url'] in /etc/groupoffice/ Replace localhost with because the license doesn't allow localhost to be used:

GO will connect to this installation to add a mailbox. It is the full url to the Group-Office installation with the postfixadmin module installed.

Put the licenses from the Intermesh Software Shop in /usr/share/groupoffice and then login to Group-Office again. The professional modules should be available for installation now at Start menu -> Modules.