Detailed installation instructions

Examples are using MySQL, Apache and general UNI* syntax! They may (or may not) work for your environment...

  1. Obviously you need a running webserver with support for PHP. If you don't have one yet, explaing how to install a webserver is beyond the scope of this document. You may find some hints in the documents explaining how to set up more.groupware on Win32 (see file "Windows" in docs directory) and RedHat (see file "RedHat" in docs directory) and at various places around the Internet (e.g. httpd.apache.org ).

  2. And you need a database server. See previous item for tips on how to install this.

  3. If you want, you can set up a virtual host for use with more.groupware exclusively. See your webservers documentation on how to do this. You should also consider using SSL to add security to your setup!

  4. Extract the more.groupware distribution archive to the desired location (i.e. to the document root of your (new) (virtual) host. You may safely rename the more.groupware folder to make typing in the URL faster, or to add some more "security through obscurity"

              #> cd /path/to/your/docroot/
              #> tar xzf moregroupware-x.y.z.tar.gz
            

  5. Make sure your webserver has the right to write to the more.groupware directory. This is needed to create the configuration file during setup, as well as the directories for template caching and the modules. The easiest way is to make the more.groupware directory world writable. Unfortunately this is the most insecure method as well, so you should consult your webserver's documentation on how to this in a more secure manner.

              #> chmod o+w moregroupware/
            

  6. Create a database for use with more.groupware. If you cannot do this (e.g. because you are in a shared hosting environment and have no rights to do so), you may use an existing database - all tables created by more.groupware have a prefix of "mgw_". But creating an own database is by far the preferred method!

              #> mysqladmin -u root -p create moregroupware
            

  7. Create a database user for use with more.groupware. This user must have the rights to SELECT, INSERT, UPDATE and DELETE in the more.groupware database. Furthermore the USER must be able to CREATE tables. During setup the user additionally needs DROP rights, which may be removed again after successful setup.

              #> mysql -u root -p mysql
              !> INSERT INTO user (host,user,password,select_priv,insert_priv,update_priv,
              delete_priv,create_priv,drop_priv) VALUES ('localhost','moregw',
              PASSWORD('securePW'),'Y','Y','Y','Y','Y','Y');
            

  8. Now point your favourite browser to the setup directory (e.g. http://yourdomain.com/moregroupware/setup/index.php). Follow these instructions during installation. If errors occur, the setup will (in most cases) tell you exactly what went wrong. You may fix the issue and repeat the last step, until you got everything right.