Manual from Tarball

We strongly recommend that you use our Debian packages or Docker over this method. But if you really want to use the Tarball source then here is how.

System requirements

You need a Linux server with:

Type Requirement
Operating System Linux / Docker
Webserver Apache 2+
Database MySQL 5.7+ / MariaDB 10.0.5
Programming language PHP 7.0+

Required PHP Extensions

  • pcre
  • mbstring
  • ctype
  • date
  • iconv
  • curl
  • zip
  • soap
  • gd
  • pdo
  • pdo_mysql (With mysqlnd, nd_pdo_mysql)
  • mysqlnd
  • calendar


  • acpu (for better caching performance)
  • ioncube (For professional version with Intermesh support)


  1. Grab the source from:


    For PHP 7.0 use the -php-70.tar.gz file. For all newer PHP version use the php-7.1.tar.gz file

  2. Put the unpacked source in apache’s document root.

  1. Make sure to make some aliases in the Apache configuration:

    Alias /public <YOURDOCUMENTROOT>/public.php
    Alias /Microsoft-Server-ActiveSync <YOURDOCUMENTROOT>/modules/z-push/index.php
    #For CalDAV support
    Alias /caldav <YOURDOCUMENTROOT>/modules/caldav/calendar.php
    #For CardDAV support
    Alias /carddav <YOURDOCUMENTROOT>/modules/carddav/addressbook.php
    #For WebDAV support
    Alias /webdav <YOURDOCUMENTROOT>/modules/dav/files.php
    #For WOPI support (Collabora Online and Office Online)
    Alias /wopi <YOURDOCUMENTROOT>/go/modules/business/wopi/wopi.php
    #DAV Service discovery. At least required for iOS7 support
    Redirect 301 /.well-known/carddav /carddav
    Redirect 301 /.well-known/caldav /caldav

    Or if you’re not able to add these aliases you could create a .htaccess file and use mod_rewrite rules. Replace <YOURDIR> with the relative URL of where Group-Office is installed:

    RewriteEngine On
    # The followng two lines are only necessary when using PHP in CGI mode and not an apache module
    RewriteCond %{HTTP:Authorization} ^(.*)
    RewriteRule .* - [e=HTTP_AUTHORIZATION:%1]
    # Configure /webdav, /caldav etc. on your domain
    RewriteRule ^webdav(.*)$ /<YOURDIR>/modules/dav/files.php
    RewriteRule ^caldav(.*)$ /<YOURDIR>/modules/caldav/calendar.php
    RewriteRule ^carddav(.*)$ /<YOURDIR>/modules/carddav/addressbook.php
    RewriteRule ^wopi(.*)$ /<YOURDOCUMENTROOT>/go/modules/business/wopi/wopi.php
    RewriteRule ^Microsoft-Server-ActiveSync(.*)$ /<YOURDIR>/modules/z-push/index.php
  2. If you purchased Group-Office Professional licenses then make sure the Ioncube loader is installed and place the license files in the root folder of Group-Office. For example “/usr/share/groupoffice/groupoffice-pro-6.3-license.txt”.

  3. Then visit http://yourserver/ and the installer should appear:

    The Group-Office installer

    The Group-Office installer

  4. Follow the instructions on screen.

  5. Finally, create a cron job for the scheduled tasks:

    * * * * * www-data php <YOURDOCUMENTROOT>/cron.php

    Optionally you can add the config file location:

    * * * * * www-data php <YOURDOCUMENTROOT>/cron.php /etc/groupoffice/myoffice/config.php

Authentication with CGI or FastCGI

When using PHP through CGI the “Authorization” header might not be passed by default. You can enable this header by adding these “mod_rewrite” rules to your VirtualHost section or .htacess file:

RewriteEngine On
RewriteCond %{HTTP:Authorization} ^(.*)
RewriteRule .* - [e=HTTP_AUTHORIZATION:%1]