|This manual is deprecated. Please visit https://groupoffice.readthedocs.io for the latest documentation.|
Installing on Debian or Ubuntu
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 >= 8 or Ubuntu >= 16.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/ sixtwo main
Note: If you run php 7.1 you need a different build because Ioncube is not backwards compatible. Replace "sixtwo" with "sixtwo-php-7.1"
You can do that easily by executing the following command in the terminal:
echo -e "\n## Group-Office repository\ndeb http://repos.groupoffice.eu/ sixtwo 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 pool.sks-keyservers.net --recv-keys 0758838B gpg --export --armor 0758838B | sudo apt-key add -
If that does not work, then try it over port 80
gpg --keyserver hkp://p80.pool.sks-keyservers.net:80 --recv-keys 0758838B gpg --export --armor 0758838B | 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
Install the package
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
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
Note: on the latest debian jessie I had to set this in /etc/clamd.conf:
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/main.cf 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:
Username: firstname.lastname@example.org (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']='domain.com'; If you'd like to add more you can simply enter them there in a comma separated list. eg. \$config['serverclient_domain']='domain.com,domain2.com';
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:
Debian 8 / Ubuntu 16.04
1. Download the ioncube loaders for your system at http://www.ioncube.com/loaders.php
2. Unpack the loaders in "/usr/local/ioncube"
3. Create a file "ioncube.ini" in "/etc/php5/mods-available/" or "/etc/php/7.0/mods-available/" on systems with PHP 7.0+.
; priority=00 zend_extension=/usr/local/ioncube/ioncube_loader_lin_<PHP-Version>.so
**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/ioncube_loader_lin_5.6.so)
4. Then execute the following command:
**Please note that on older systems you'll need to use "php5enmod" instead.
This creates a symlink "00-ioncube.ini" in both folders
5. Check if ioncube works with:
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:
- Look up the download link at http://www.ioncube.com/loaders.php. Right click on the download link and select copy link location.
- 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.
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
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 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:
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/';
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.