Configuration file

The configuration file can be found in:

  • /etc/groupoffice/config.php
  • /etc/groupoffice/multi_instance/<DOMAINNAME>/config.php
  • The root of the Group-Office installation

Here’s a list of config options:

Config options
Name Type Description
db_name string Database name
db_host string Database server hostname
db_port string Database server port
db_user string Database username
db_pass string Database password
file_storage_path string Where the files on disk are stored
tmpdir string Temporary files directory
sseEnabled bool Enable Server Sent Events for live push updates. Some servers don’t support two connections!
quota int Max storage in bytes this installation may use
max_users int Max number of users this system may have
allowed_modules string Comma separated string of modules the system may use
product_name string For branding the system to another name
debug bool Enable debugging for developers. Can also be temporarilty enabled with CTRL + F7 or Cmd + F7 in the browser.
debugLog bool Disable debug log when debug = true.
servermanager bool Set by multi_instance module. This will copy system settings and create welcome message on install.
zpush2_loglevel int Set to 32 to generate debugging info in log/z-push.log
vmail_path string Customize where mail is stored. Defaults to “/var/mail/vhosts/”
custom_css_url string URL to stylesheet to load in the web interface.

Locking system settings

Configuration properties configurable in the GUI at System settings can be locked in the config.php or file:

$config['core'] => [
    'title' => 'Pinned title',
    'primaryColor' => '2E7D32',
    'passwordMinLength' => 6,
    'smtpEncryption => 'tls',
    'smtpHost => 'localhost',
    'smtpUsername => null,
    'smtpPassword => null,
    'smtpPort' => 587


If you’d like to brand Group-Office you can easily do this:

Edit /etc/groupoffice/ and add:

$config['product_name'] = 'My Office'; //Will replace the word 'Group-Office' with 'My Office'
$config['custom_css_url'] = '/branding/style.css'; //Loads a custom CSS stylesheet.
$config['support_link'] = ''; //Changes the URL behind "Help" in the main menu. Can also be an e-mail address

In the branding folder create a style.css stylesheet with for example this content:

 * Preferred primary theme colors
:root {
    --c-primary: rgb(27, 100, 139);
    --c-header-bg: rgb(27, 100, 139);
    --c-primary-tp: rgba(27, 100, 139, .16);
    --c-secondary: brown;
    --c-accent: orange;

 * Override logo
.go-app-logo, .go-about-logo, .go-settings-logo, #go-logo {
    background-image: url('my-group-office.png');
    width: 240px;
    height: 40px;


It will still leave copyright notices to Intermesh. It’s not allowed to remove those.