@ -19,26 +19,39 @@ This version of Chamilo requires the following software stack.
</ul>
Within PHP, Chamilo requires or benefits from the following extensions:
<ul>
<li>session (php-session, usually shipped with PHP)</li>
<li>mysql</li>
<li>zip</li>
<li>zlib</li>
<li>pcre</li>
<li>xml</li>
<li>curl</li>
<li>exif</li>
<li>gd</li>
<li>iconv</li>
<li>intl</li>
<li>json</li>
<li>gd</li>
<li>curl</li>
<li>mbstring</li>
<li>exif</li>
<li>mysql</li>
<li>opcache</li>
<li>iconv</li>
<li>pcre</li>
<li>session (php-session, usually shipped with PHP)</li>
<li>xml</li>
<li>zip</li>
<li>zlib</li>
<li>ldap (optional)</li>
<li>xapian (optional)</li>
</ul>
<h2>Database</h2>
<h2>Web-panel installation</h2>
<h3>Database</h3>
Make sure you have a database available with full permissions.
Do not share that database with another application as Chamilo might need to create
a table that has the same name as a table in the other application.
<h3>Virtual host</h3>
Define a new virtual host/subdomain name you will use for Chamilo (Chamilo 2 does *not* work as a sub-folder of an existing website, you need a subdomain like "elearning.yourdomain.com").<br>
Upload and/or unzip your Chamilo files inside your web folder (usually inside a folder called "public_html/").<br>
Configure a virtual host pointing at the "public" directory inside your Chamilo directory. For example, this could be "/home/elearning.yourdomain.com/public_html/chamilo2/public/".<br>
<h3>Installation wizard</h3>
You are ready to go. Open your browser on your subdomain (elearning.yourdomain.com in the example above), keep your database credentials at hand, and let the Chamilo installer guide you.
<h2>Command line installation</h2>
<h3>Database</h3>
You will need a database user with privilege to fully use (and optionally create) a database.<br>
Although progress has been made to support multiple database management systems, Chamilo currently only supports MariaDB and MySQL.<br>
Although progress has been made to support multiple database management systems, Chamilo
currently only supports MariaDB and MySQL.<br>
Setup a new user in your database system either through visual tools or directly in the terminal:<br>
<pre>
mysql> GRANT ALL PRIVILEGES ON [db-name].* TO [db-user]@[db-host] IDENTIFIED BY '[db-password]';
@ -53,14 +66,14 @@ where:
<li>[db-host] is the name of the database server (use <em>localhost</em> when using the same machine for web server and database server - if you use a hosted service, your hosting provider will usually give you this name somewhere)</li>
<li>[db-password] is the password this user will use to connect to this database on this host. Use common sense to not make it too easy to guess (use special characters, lowercase and uppercase, numbers, and a length of *at least* 8 characters)</li>
</ul>
<h2>Web server</h2>
<h3>Web server</h3>
Chamilo 2+ only requires a working web server setup to work. You can run it on localhost with the default installation of any web server, provided you configure your DocumentRoot as the path pointing to Chamilo's <em>public/</em> subfolder.<br>
Here is a minimal example Apache vhost configuration file for an installation on the http://my.chamilo.local/ URL (replace all values between brackets, including the brackets, to your custom values):
@ -73,13 +86,15 @@ After setting up this virtual host, don't forget to enable it (example here on D
a2ensite [my.chamilo.local]
systemctl reload apache2
</pre>
Then you should be able to direct your browser to your URL (e.g. <em>[http://my.chamilo.local]</em>).<br>
<h3>Installation wizard</h3>
You should now be able to direct your browser to your URL (e.g. <em>[http://my.chamilo.local]</em>).<br>
Chamilo will pick it up from there and offer the installation wizard to help guide you through the rest of the process.
<h2>Help available</h2>
If you are struggling with this guide, don't hesitate to ask for help on <ahref="https://github.com/chamilo/chamilo-lms/discussions">our community forum.</a><br>
If you have reasons to seek professional assistance and warranties, please contact <ahref="https://chamilo.org/providers">one of our official providers</a>. They contribute heavily to the project and will be able to help you out quickly and efficiently, for configurations from 10 to 1M users.<br>
Yannick Warnier
4 months ago