Installing on Debian or Ubuntu

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

Contents

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/ fivezero 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/ fivezero 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 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/main.cf and set:

relayhost=smtp.example.com

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: *****


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.

Video

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

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/';


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.

Note: Please make sure that you have installed the groupoffice-com package before installing groupoffice-pro.

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
Personal tools
Namespaces
Variants
Actions
Navigation
Manuals
Toolbox