Community wiki

Community wiki

Manage Header

The file '' is a text file containing fundamental configuration settings for eGroupWare. These include settings which can't be stored in the database, such as, e.g., the name of the database itself.

You can determine the following settings:
  • Server Root e.g. for Windows: C:/Programs/xampp/htdocs/egroupware or for Linux:
    /var/www/html/egroupware or for Mac OS-X: /Applications/xampp/htdocs/egroupware
    These settings are usually automatically recognised and should generally not be changed.
  • Include Root (this should be the same as Server Root unless you know what you are doing)
  • Admin user for header manager e.g. admin, and a, Admin password to header manager
    This admin-user is needed if changes will be made to the header file after installation. (e.g. additional sessions (eGroupWare Domains)) - the lower Login-field of Setup
  • Limit access to setup to the following addresses, networks or hostnames (e.g.,10.1.1,
    Important, since the Setup-Login has no protection against brute-force attacks (random password attempts).
  • Persistent connections: Do you want persistent connections (higher performance, but consumes more resources)?
  • Sessions Type: What type of sessions management do you want to use?
    • PHP session management may perform better)
    • PHP plus restore gives by far the best performance, as it stores the eGW enviroment completly in the session. Unfortunally some PHP/Apache packages have problems with it (Apache crashes and you can't login anymore).
    • 'Database': Saves the session in a database -is the slowest
  • Enable MCrypt: Not all mcrypt algorithms and modes work with eGroupWare. If you experience problems try switching it off.
    Use MCrypt if you are located on a 'shared-Webhost' (i.e. multiple users share a webserver, often the case in purchased webspace) since otherwise passwords, for example, are not encrypted and can be read by other host users!
  • MCrypt initialisation vector: This should be around 30 bytes in length. (Note: The default has been randomly generated.) It is recommended that you don't change anything here.
  • Domain select box on login: If you use multiple database sessions (eGroupWare Domains), you can select these via a drop-down list when logging in. Otherwise, you can also access the various database sessions via "username@session"; for the 'default' session (the first domain created), you may enter only the user name.
  • Datebase: Use the text field (automatically set to 'default') to select, and the tickbox to delete, a domain.
  • DB Type: Which database type do you want to use with eGroupWare? You may choose among all installed databases, for which a php extension was "found" (see als Check Installation)
  • DB Host: Hostname/IP of database server. If you are using Postgres, leave this empty to use the prefered unix domain sockets instead of a tcp/ip connection. If you are running ODBC / MaxDB, enter a DSN (data source name) to use
  • DB Port: TCP port number of database server
  • DB Name: You may enter a name for your database in this text field (do not use any spaces or special characters). The default is "egroupware".
  • DB User: Name of the DB-user that eGroupWare uses to connect, in conjunction with the DB Password.
  • Configuration User und Configuration Password: Password that is needed for the configuration login, the upper of the two logins at Setup. If you use only one database session (eGW Domain), you should use the same user name and password as for the Header Management.

Below these options, there are three buttons for
  • [Create Configuration]: saves your configuration in the file '', if the webserver has write privileges in your eGroupWare installation directory, which is not recommended on a permanent basis!
  • [Download]: Here you can download your settings (automatically named '' from the webserver to you local computer and then, e.g. saved via FTP back to the eGroupWare installation directory.
  • [View]: Shows the file with all settings.

User Manual / Installation of eGroupWare

The user manual is written by Outdoor Unlimited Training GmbH, who also offers support together with Stylite AG, see eGroupWare support.
You are here