eGroupware – web-based groupware suite Setup

Sponsored Link
eGroupWare is a Web-based groupware suite. It contains many modules, including Calendar (personal calendar and group scheduling, notifications and alarms), Mail (Email (IMAP and POP3) or FeLaMiMail (IMAP only)), InfoLog (todos, notes, and phone calls linked to contacts (CRM)), Contacts (an addressbook to store and share contact information), and SiteMgr or JiNN (content management).

eGroupware requirements

  • System software e.g. Linux, Windows or MacOSX
  • Downloading the eGroupWare Package
  • Webserver and php-Interpreter e.g. Apache, IIS recommended Apache 2, min. php 4.3, recommended php 5
  • Database (SQL) e.g. MySQL, Postgres, MaxDB, MSSQL min. MySQL 4.0, recommended MySQL 4.1 or 5.0
  • SMTP-Server e.g. Postfix
  • Client Browser e.g. Firefox, Internet Explorer
  • Client IMAP-Server e.g. Cyrus (POP3 also possible, supported only by Anglemail -- not by the standard email application FelaMiMail.

Before installing egroupware you have to install apache2 and mysql with php support

Web Server Setup

Install apache2 with php support check here
Database Server Setup

Install mysql with php support

sudo apt-get install mysql-server mysql-client libmysqlclient15-dev

sudo apt-get install php4-mysql

If you want to install php5 support use the following command

sudo apt-get install php5-mysql

Install postfix in Ubuntu

sudo aptitude install postfix mailx php5-imap

choose satellite system and just press enter when asked other questions, but don't select any relay host (remove

Change /etc/mailname to say:

Change /etc/aliases such that,

# Added by installer for initial user
root: [email protected]

Replace [email protected] with your own e-mail address!

Finally, do as root


restart postfix using the following command

sudo /etc/init.d/postfix restart

and if you want to install imap or pop3 servers you can install of your choice and this is only optional.

Installing eGroupware in Ubuntu

sudo aptitude install egroupware

This will start the installation process and you see the following screen first

Now it will ask for which webserver you want to configure for egroupware i am using apache2 and select which one you are using from the list.

Enter the which user you want to use for header user admin and i have entered admin and click on ok

enter the header admin user password

Confirm the header admin password

this time you have choose the option for libc-client without maildir support and i am selecting yes and click on ok

That’s it this will complete the egroupware basic installation.

Go to http://yourserverip/egroupware/setup/ to setup egroupware

Select Your Language and click on "Run Installation Tests"

Now you should see similar to the following screen here you need to click on "Continue to the Header Admin"

Enter your header user admin username and password to login.

Once you login you should see the following screen in this you need to enter all the required fields with the exact information.Important one is enter the configuration username and password for you to login after installation .You click on Add new database instance and write config click on continue. created click on continue

Now you need to enter the setup/config admin login details and click on login

Here you need to enter DB root username,password and click on Create database

you should see the following screen with red cross marks first thing is you need to click on install button to install all the required applications

Now you should see the following screen with two red cross marks this means you have to setup mail server settings, create the admin account.

Once you created everything you should see similar to the following screen

Now you need to login using the following URL

http://yourserverip/egroupware/ enter your configuration admin username and password to login

Once you logged in into the egroupware you should see similar to the following screen

Sponsored Link

You may also like...

26 Responses

  1. john says:

    hey thanks for the info. i am very happy for every thing
    i first setup failed but thanks to your notes
    it went through very very well
    thanks a lot for everything and look forward to hearing from you

  2. Andy says:

    Excellent instructions. I managed to get everything working on my 8.04 LTS server, apart from IMAP support. apt-get install php5-imap didn’t work as it seemed to think it was already installed. But egroupware was having none of it.

    sudo apt-cache policy php5-imap


    Installed: 5.2.3-0ubuntu3
    Candidate: 5.2.3-0ubuntu3
    Version table:
    *** 5.2.3-0ubuntu3 0
    500 hardy/universe Packages
    100 /var/lib/dpkg/status

    Any ideas?

  3. Stefano says:

    I found in a web site the following solution that worked for me.

    Make sure to also do a:

    /etc/init.d/apache2 force-reload

    as the php5-imap is installed after the apache2 server is restarted and will not be loaded. The installation should be change so that the server is reloaded at the end of install.


    hope helps somebody,


  4. Patrick says:

    /etc/php5/conf.d/imap.ini is not created by installation process, so
    when we restart apache and we try to use php-imap module it doesn’t work
    because it wasn’t loaded by php5.
    Creating the /etc/php5/conf.d/imap.ini file containing:
    # configuration for php IMAP module
    during the installation phase will solve the problem.

    Found when I went a googling.

  5. joinkzz says:

    Checking file-permissions of .././etemplate/doc for not world writable:
    .././etemplate/doc does not exist !!!

    can anyone help me with this?

    thank you guys!

  6. joinkzz says:

    * You appear to have MySQL support.
    * You appear to have MySQLi (php5) support.
    * No PostgreSQL support found. Disabling
    * No MS SQL Server support found. Disabling
    * No ODBC support found. Disabling
    * No Oracle support found. Disabling
    * You appear to have PHP session support. Enabling PHP sessions.
    * Found existing configuration file. Loading settings from the file…
    * You need to add some domains to your

    is this ok? i think i missed some things…

  7. wayward4now says:

    I’d like to know how to solve that doc’s not found error too… I hope someone posts a fix. Thanks! Ric

  8. jaredyohc says:

    I went through all the steps up until the part where we either create a new database or RE-Check Database. It doesn’t allow me to create a new one, just re-check it. I’m running on PGSQL, am I supposed to be running my SQL? How do I back up out of this if this is the case and redo??

    Thank you!

  9. Rich says:

    I too am having problems with permissions and the
    Checking file-permissions of .././etemplate/doc for not world writable:
    .././etemplate/doc does not exist !!!”
    and am not finding a fix with lots of googling.

    Has anyone figured this out for an install on Ubuntu server 9.04 ?


  10. jimbo says:

    @Rich: had the same issue. quick fix was to rm that sym-link, /usr/share/egroupware/etemplate/doc and cp -r what it’s pointing to, /usr/share/doc/egroupware/etemplate/doc or whatever it was. after fixing the first one, it’ll do the same thing again with another sym-link, just do the same thing with it’s proper directory and you should be set.

  11. Rich says:

    Thanks ‘jimbo’! I am now past the Installation Check but am stuck at Step 1 of Setup…
    rcvg this …

    backupdir ‘/var/lib/setup/default/backup’ is not writeable by the webserver*

    and cannot fix it even with a chmod 777 of the entire path.

    Are these bugs in the install and config scripts?

    Sure wish this install was less error prone 🙁

  12. Summer says:

    In installation test finally got no errors, only advertisement of Oracle, but I use mysql, but in login windows still:

    Your session could not be verified.

    what’s wrong?

  13. wayward4now says:

    Summer, I have had the same problem since day one. I too would like to know how to fix this. Thanks to the Ubuntu Crew for their efforts. Ric

  14. Rich says:

    2nd try at an install worked… not sure what I did differently , but I followed the above instructions carefully this time with no shortcuts.
    Ubuntu 9.04 Server + did the Apache2 and MySql install part anyway (even thou these come with Unbuntu) + the egroupware install…
    main difference is I left the Ubuntu srvr quite bare and did the eGW setup from another computer using a browser (1st attempt was all on the Unbuntu srvr after adding a GUI and browser and other stuff) to the Ubuntu install ISO.

    I am willing to try to answer questions if others try this and have any problems.


  15. Ken says:

    Hi Rich

    I see you have a very recent install experience with eGroupware. Are you using this in a production environment?

    I was hoping to install on an 8.04 LTS server I just built, but am trying to decide if I should go native on the O/S or build a VM in VirtualBox.


  16. Rich says:

    Sorry this reply is so late… just going ‘production’ with Ubuntu 9.04 server and eGW 1.4 this week. It is our new company ‘intranet portal’. Kind of a steep learning curve, and behind schedule, but so far so good!

  17. Rich says:

    I am using Ubuntu ‘native’. I would not try in VM mostly from my lack of experience with eGW and the VM environment.

  18. Shane says:

    About the doc not found error.

    After lots of head scratching, I bit the bullet and went back a generation in the server OS from JJ (Ubuntu 9.04) to HH (Ubuntu 8.04lts).

    All of the permissions errors disappear as long as you follow the apache/php/mysql install guide also referenced here.

    Don’t forget to create a mysql database for egroupware first (egroupware is a good name for it) and to also create a mysql user (again egroupware seems appropriate) and not to forget to set permissions to be all and a password of your choosing (as i was on a roll, egroupware got to be that as well!). If you do not create the database to begin with when you try to populate the db it will fail.


  19. joe325 says:

    sudo rm /usr/share/egroupware/etemplate/doc
    sudo cp -R /usr/share/doc/egroupware-etemplate/ /usr/share/egroupware/etemplate/doc
    sudo rm /usr/share/egroupware/sitemgr/doc
    sudo cp -R /usr/share/doc/egroupware-sitemgr/ /usr/share/egroupware/sitemgr/doc

  20. cyberdoo78 says:

    Following joe325 directions under Ubuntu 10.04 using egroupware 1.6.001 resulted in an error in finding sitemgr-link. Found sitemgr-link.php in the sitemgr directory. Fixed by linking the file correctly.

  21. ohcee says:

    @cyberdoo78 can you elaborate a bit more, Im having the same issue.. thanks.

  22. cyberdoo78 says:


    Use this command and it should fix ya up:

    sudo ln -s /usr/share/egroupware/sitemgr/sitemgr-link.php /usr/share/egroupware/sitemgr-link.php

  23. nym says:

    for my installation the cyberdoo78 solution does not work, I’ve fixed with:

    sudo rm /usr/share/egroupware/sitemgr-link
    sudo ln -s /usr/share/egroupware/sitemgr/sitemgr-link-php /usr/share/egroupware/sitemgr-link

    seem to search the file without extension


  24. ahmad javadi says:

    i am using ubuntu server 10.04
    and do installation steps completely but when i want to login the ” Your session could not be verified” showed please help me to solve it ?

  25. DFSI says:

    I also encountered this problem during install on Ubuntu 10.04.2 LTS

    I fixed like this :

    Each time I had a link called ‘doc’ (etemplates, sitemgr) I remove it and create a new folder
    sudo rm doc
    sudo mkdir doc
    sudo chown -R www-data:www-data doc
    sudo chmod -R 775 doc

    About these links :
    /usr/share/egroupware/sitemgr -> /usr/share/egroupware/sitemgr/sitemgr-link-php


    sitemgr-link.php -> /usr/share/egroupware/sitemgr/sitemgr-link.php

    I simply removed them, and check is OK…

    And it seems to work for me.

  26. Richard says:

    I seem to get to the setup/config admin login page and it will not accept the password. I have used the same password for the mysql user and when the database was added. I have also started again from scratch (new ubuntu 10.04 LTS installation – still no success). I can log in to the header admin account only.
    Any suggestions!

Leave a Reply

Your email address will not be published. Required fields are marked *