About Dokeos Installation Guide GPL license Credits Dependencies Changelog Website

Guía de Instalación de Dokeos

Dokeos 2.0 Installation Guide

Thank you for downloading Dokeos 2.0


  1. Pre-requisites
  2. Installation of Dokeos LMS
  3. Upgrade from a previous version of Dokeos
  4. Troubleshooting
  5. Administration section
  6. LDAP 
  7. Oogie PowerPoint / Impress conversion
  8. Videoconferencing
  9. Mathematical formulas with LaTeX
  10. Multiple access URL

1. Pre-requisites

Dokeos can be installed on Windows, Linux, Mac OS X and UNIX servers indifferently. However, we recommend the use of Linux server for optimal flexibility, remote control and scalability.

Dokeos is mainly a LMS running Apache 2, 2.0, MySQL 5.1 and PHP 5.3 (the so called AMP trilogy).

All these software are open source and freely available.

To run Dokeos LMS on your server, you need to install WAMP, LAMP or MAMP:

MySQL database server

You will need a login and password allowing to administrate and create at least one database. By default, Dokeos will create a new database for each course created. It means your host should allow you to create and administrate several databases. You can also install Dokeos using only one database, in that case you have to select this option during the installation.

2. Installation of Dokeos LMS

The following directories need to be readable, writeable and executable for everyone: (where 'dokeos' is the directory in which you installed Dokeos)

On Linux, Mac OS X and BSD operating systems you can use the CHMOD 777 command for this (although we recommend you seek advice from an experienced system administrator). In Windows, you may need to check the properties of the folders (by right-clicking on them).

2.5. The following files need to be readable and writeable for the web browser, only during the installation process:

On Linux, Mac OS X and BSD operating systems you can use the CHMOD 666 command for this (although we recommend you seek advice from an experienced system administrator). In Windows, you may need to check the properties of the files and folders (by right-clicking on them).

Do not modify the home_*.html files directly. Instead, choose "Configure the homepage" in the Dokeos administration section.

Windows : with combination packages like XAMPP, out of the box, login and password for MySQL should probably remain empty.

Configuration and security after installation

PHP configuration

To get the best of Dokeos, you need to finetune PHP settings. Consider :
max_execution_time = 300    ; Maximum execution time of each script, in seconds
max_input_time = 600 ; Maximum amount of time each script may spend parsing request data
memory_limit = 512M      ; Maximum amount of memory a script may consume (128MB)
post_max_size = 64M
upload_max_filesize = 200M

Some users could meet problems if their PHP settings don't fit these ones:

Past Dokeos versions required register_globals to be set to On. This is no longer necessary, this can be set to Off and Dokeos will work fine.

BSD users: these php libraries have to be included during php installation:

You might also add the following php modules and packages:

3. Upgrade from a previous version of Dokeos

Before upgrading we heavily recommend you do a full backup of the previous Dokeos directories and databases. If you are unsure how to achieve this please ask your hosting provider for advice.

3.1 Upgrading from Dokeos 1.8.x

If you upgrade from Dokeos 1.8.x * Styles and images are located in the main/css or main/img directories. You can still recover them from your backup if you have made it. Any modified style or image that uses the default style/image name will be overwritten by the next step. To avoid loosing your customisations, always ensure you copy the styles/images under a new name and use and modify the copy, not the original. The original will always be overwritten by newer versions. In Dokeos 1.8.5, we have changed the name of several CSS themes. Backwards compatibility is ensured by the fact that an upgrade only adds the new themes, but you should try and use these new themes rather than sticking to the old ones which will be deprecated shortly (not maintained).

3.2 Upgrading from Dokeos 1.6.x

An easy way to do that is to create a subdirectory called "old_version" in your current Dokeos directory and move everything in there using a simple "move" command (i.e. under Linux: mkdir old_version; mv * old_verion/), then make the old_version/ directory writeable by the web server so that courses/ and upload/ directories can be moved from the old to the new installation.