You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
In this beta version, there are known issues with sessions not getting updated fast enough, which can be solved (temporarily) by using a Redis server. Check the command line instructions for more about this. This is a temporary situation that we expect to fix before the stable release.
99
-
99
+
100
100
<h3>2.7. Clean up</h3>h3>
101
101
<aid="web-cleanup" class="anchor"></a>
102
102
As recommended by the installer's last page, make sure you change permissions on the config/ dir and the .env file, and you delete the public/main/install/ folder.
Please be aware that upgrading your system might take hours or even days, depending on the size and complexity of your database. Refer to the Chamilo forum or to official providers for help.
265
265
266
-
<h2>6. Installing on Windows</h2>
267
-
<aid="windows-install" class="anchor"></a>
266
+
<h2>6. Installing on Windows with WAMP</h2>
267
+
<aid="windows-install-wamp" class="anchor"></a>
268
268
<h3>6.1. Introduction</h3>
269
269
Although Chamilo does work on Windows, it is not officially supported due to the fact that
270
270
we have limited testing capabilities for this operating system. The following instructions have been
271
271
tested on a Windows 11 (desktop) machine with the WAMP application.
272
272
We do not recommend using Windows for production environments.
273
273
274
274
<h3>6.2. Installation for validation or production</h3>
Click on the WampServer icon in the status bar (bottom right) and select PhpMyAdmin.<br>
308
308
Choose the MariaDB service and connect to the root user. Enter the root password you set during WampServer installation (probably still empty).<br></br>
309
309
In the "Databases" tab, prepare a new database with the name "chamilo2".<br></br>
Open your browser on <ahref="http://chamilo.local/">http://chamilo2.local</a>. The installation wizard should appear.<br>
408
408
Follow the instructions to complete the installation.<br>
409
409
410
410
Note that it is difficult to change URLs later, so if you plan to publish this service online, make sure you have properly configured your domain name first.
411
411
412
-
<h3>6.4. Redis</h3>
412
+
<h3>6.4. Windows install with IIS</h3>
413
+
<aid="windows-install-iis" class="anchor"></a>
414
+
For performance reasons, you might want to install Chamilo on Windows using IIS as a web server.<br>
415
+
The procedure described below is experimental, so if you believe you can improve this, please open an issue on Github for us with the proposed changes.<br><br>
416
+
417
+
<h4>6.4.1. MariaDB</h4>
418
+
<aid="windows-install-iis-db" class="anchor"></a>
419
+
First install MariaDB from the official website (https://mariadb.org/download/) and follow the default installation options (Next, Next, Install).<br>
420
+
Make sure you have a database Windows client at hand as we will have (preferrably) to define permissions for a Chamilo-specific user.<br>
421
+
Once installed, open the database client and create a user through the interface or issuing the following query (adapted to your needs):<br>
422
+
<pre>mariadb> GRANT ALL PRIVILEGES ON chamilo.* TO chamilo@localhost IDENTIFIED BY 'some-password';</pre>
If you are working on a Windows server, you should have IIS installed already. If not, you can download it from the official website (https://www.iis.net/downloads).<br>
428
+
With IIS, you will need the URL Rewrite module. You can download it from the official website (https://www.iis.net/downloads/microsoft/url-rewrite).<br>
429
+
Once installed, you will need to restart IIS, close the network manager window if open, and possibly reboot the whole Windows machine for it to appear in the Site management (not the server management section).<br>
Once you have installed IIS and the URL Rewrite module, you will need to configure the CGI and PHP settings.<br>
434
+
CGI is an IIS module to enable (it's already present but needs activating) in the server manager. Open the server manager, click Manage > Add roles and features > pass screens until "Server roles". Select "CGI" under "Web Server (IIS) > Web Server > Application Development, then confirm the installation.<br>
435
+
Download PHP 8.3 for Windows from the official website (https://windows.php.net/download#php-8.3) (simple Zip version).<br>
436
+
This might require (depending on your setup) to install the VC++ libraries in version 14, which come from VStudio v16 (between others). If you don't have them yet on the Windows Server, you can download them from here depending on your architecture: <ahref="https://aka.ms/vs/16/release/VC_redist.x64.exe">x64</a> or <ahref="https://aka.ms/vs/16/release/VC_redist.x86.exe">x86</a>.<br>
437
+
Add PHP to the PATH environment variable (e.g. C:\php): Settings > System > About > Advanced system settings > Environment variables, then select "Path", click "Modify", click "New" and introduce "C:\PHP", then validate twice.<br>
438
+
In the IIS manager window, when the server is selected and you click on the Mappings manager, click on the "Add module mapping..." in the right panel and make sure request path "*.php" is mapped to the FastCgiModule. If not, add it.<br>
439
+
Find the C:\php\php.ini file (or any other place you might have given the PHP installer script to register to) and set (or wait for the install wizard to tell you) the settings suggested by Chamilo's install wizard. Between others, make sure the opcache section has <em>opcache.enable=1</em> *and* <em>opcache.memory_consumption=256</em> or any higher value so that OpCache can be used. Otherwise it is present but not used. Save the file.<br>
Once you have installed IIS, the URL Rewrite module and PHP, you can download Chamilo from the official downloads page (https://github.com/chamilo/chamilo-lms/releases).<br>
444
+
Unzip the package in the "wwwroot" folder of your IIS installation (e.g. C:\inetpub\wwwroot).<br>
445
+
Chamilo 2+ need you to configure the web server so the root path is the "public/" folder of Chamilo.<br>
446
+
Create an empty ".env" file at the root of the chamilo folder (e.g. C:\inetpub\wwwroot\chamilo\.env).<br>
447
+
Change permissions so the web server user is able to write to var/, config/ and .env during the installation. These permissions can be removed later on, to the exception of var/ which has to remain writable by the webserver. These permissions need to be set in a way that the owner of the IIS service (possibly "System" or "IIS_IUSRS") can read and write to those files and folders, otherwise the installation script (which needs to write some files) will not be able to proceed.<br>
448
+
After this, load the URL in your browser, as you have defined it in the ISS site configuration.<br>
449
+
The Chamilo installation wizard should appear.<br>
450
+
Follow the instructions to complete the installation.<br>
451
+
452
+
453
+
<h3>6.5. Redis</h3>
413
454
<aid="windows-install-redis" class="anchor"></a>
414
455
For better performance in the highly dynamic interfaces of Chamilo, you might
415
456
want to install the PHP Redis extension from the official PHP website, for example (adapt PHP and Redis version numbers)
0 commit comments