# The setup process

After you have unpacked more.groupware and done the necessary preparations according to the previous chapters, you are ready tu run the web-based setup procedure. It is described in full detail in this chapter. After you are through with this, check back with the platform specific instructions to make sure you don't miss anything you need to do to conclude the installation. Then read the chapter on Securing your more.groupware setup!

Start your web browser and open the URL http://localhost/moregroupware/index.php (or `http://your.doma.in/moregroupware/index.php` if you run setup at a remote computer).

As you don’t have run the setup yet you will get an error message:

## Error message after unpacking

Use the "run setup" link to start the setup process. If you want to read this manual you can choose the "look at the manual" link. If you choose to run the setup you will get the following setup screen:

## Choose language

Choose the language you want to use for the installation. What you choose here, will be the default language for your installation, i.e. the login screen will default to this language as well. After you have done the choice you must press refresh to update the output to your chosen language. Then you should read the provided explanations. Setup shows error messages and informatione if needed. If you want those messages to appear as popup windows, select 'Yes' in the drop-down box labeled 'Use javascript for errors'.

Now click Next to go to step 2:

## System check

Hopefully your computer passes the system check. If not you have to do the necessary changes in system settings before you try to run the setup again. Press Next if everything is ok.

Now it's time for some real configuration:

## Settings screen

The settings you can or need to set here have the following meaning:

Databaseproduct

  This is the type of database you use. Only MySQL and PostgreSQL work by now, but we want to support more database systems in the future. Set this to the software you use.

Database Hostname / IP

  The machine name or IP address the database runs on. If this is the same machine as the webserver, use 'localhost'. Otherwise type the name or IP, using the IP might improve the performance in extreme situations (because the name doesn't need to be resolved).

  In case of PostgreSQL as database system, just supplying user and password, with leaving the hostname blank is possible as well.

Database User

  The database user you created (or that has been created for you) for moregroupware. This is the same user you might have created in previous steps during the installation.

Database Password

  The password given to the database user you used above.

Name of database

  The database name you defined when creating an empty database for more.groupware.

URL to moregroupware root

  This is the URL that points to your more.groupware installation. It should be guessed correctly in most cases, but check anyway, just to make sure.

Skip URL check

  If setup claims the root URL is not correct, but you are sure it is, you can skip the check. Do this at your own risk...

Use dynamic URL detection

  If your server can be accessed by different names (e.g. depending on whether you access it from inside or from outside of your LAN), you need to check this. It will use the hostname supplied by the browser (as aprt of the request) instead of a hardcoded one. This will only work with HTTP/1.1, but this should be standard nowadays.

System path to moregroupware

  This is the path to the directory you unpacked more.groupware into. Should be guessed correctly, check it anyway, just to make sure.

Theme of moregroupware

  Defines the general look of more.groupware. Colours and similar things can later be defined on a per user basis through CSS-based themes. There is only one choice anyway: default.

Authentication method

  You can authenticate the more.groupware users either through LDAP, the database or NTLM/htaccess.

  Using the database is the most used and most widely tested method, so it's a safe bet. If you have your users in LDAP (OpenLDAP or Active Directory) anyway, go this way. In a Windows-based LAN NTLM might be the best choice.

Don't submit passwords with MD5 encryption

  Passwords can be submitted using a MD5 encryption. They are hashed on the client using JavaScript, to avoid sending cleartext passwords over the net. This feature is switched off automatically if no JS is available on the client, but you may completely disable it here.

  If you want real security, use SSL! If one captures the hashed password, it is as easy to break into your system, as it would be with a cleartext password!

Press Next to go to step 5:

## Authentication settings SQL/NTLM

Nothing to do here if you have chosen authentication of users via SQL or NTLM/htaccess. Press next in this case.

If you selected LDAP as authentication method, you'll see this:

## Authentication settings LDAP

Directory type

  Select your directory type, either OpenLDAP or Active Directory.

LDAP Host

  The host to connect to for LDAP queries.

LDAP Base

LDAP userid

  The user you want to use to connect to the directory server.

LDAP root password

  The password given to the user you entered in the previous field.

LDAP suffix

Create Account on LDAP login

  You can select 'Yes' here to have more.groupware automatically create accounts for users who can be authenticated successfully through LDAP. If you select 'No', you need to create those accounts manually.

After entering the needed values, click 'Next' to continue with the module selection.

## Module selection

Choose which modules you wish to install. You are forced to install the base modules, but you can decide if you want to install no, just some or all of the user modules. If modules need to be installed due to interdependancies, this will be done automatically, but the forced modules will be disabled by default. This way dependancies are satisfied, and your users only see the modules you selected.

Press next after you have done the choices.

## Installation results

Hopefully you get the message above which tells you that the installation was successfully. If not you can choose view log to see why the installation failed. There you should get enough information about what went wrong, and why. Try to fix the problems, and restart the setup.

Now comes your first login. Press login or point your browser manually to http://localhost/moregroupware/index.php for doing your first login (if you want to use NTLM authentication, use http://localhost/moregroupware/index_ntlm.php instead). Use user "admin" and password "admin" the first time. You should of course because of security reasons change the admin password as fast as possible after the installation!