Revision as of 08:56, 20 August 2012

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 http://repos.groupoffice.eu/ fourzero main

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

echo -e "\n## Group-Office repository\ndeb http://repos.groupoffice.eu/ fourzero 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://keyserver.ubuntu.com:11371 --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://pgp.mit.edu

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 on a Debian or Ubuntu installation without a mailserver configuration. Install it with the following command:

sudo apt-get install groupoffice-mailserver postfix postfix-mysql

Ubuntu 12.04 specific

On Ubuntu 12.04 not everything will be installed with the Group-Office packages. You need to install and configure some more packages:

sudo apt-get install dovecot-mysql dovecot-sieve dovecot-managesieved

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:

Host: your.hostname.com
Encryption: SSL
Protocol IMAP
Port: 993
Username: mailbox@hostname.com (Full e-mail address and not the Group-Office username) Password: *****

Video

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

<videoflash>XTaeEYb5lLE|560|340</videoflash>

Professional version

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

Then install Ioncube:

1. Look up the download link at http://www.ioncube.com/loaders.php. 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.

zend_extension=/usr/local/ioncube/ioncube_loader_lin_5.3.so

or execute:

echo -e "\nzend_extension=/usr/local/ioncube/ioncube_loader_lin_5.3.so" | 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

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 groupoffice.example.com for example. You must change the $config['serverclient_server_url'] in /etc/groupoffice/globalconfig.inc.php. Replace localhost with groupoffice.example.com because the license doesn't allow localhost to be used. If you change the admin password you should change the password in this file too:

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.
$config['serverclient_server_url']='http://localhost/groupoffice/';
#The admin account of GO. Remember to change the password here too if you change it.
$config['serverclient_username']='administrator';
$config['serverclient_password']='somepass';

Put the licenses from the Intermesh Software Shop in /usr/share/groupoffice and then run: Note: Please make sure the licenses are correct and working otherwise it is possible that the installation is not be executed completely.

apt-get install groupoffice-pro

If you have the billing package too:

apt-get install groupoffice-billing

If you have the documents package too:

apt-get install groupoffice-documents