diff options
Diffstat (limited to 'docs')
-rw-r--r-- | docs/windows-apache-installation.markdown | 126 | ||||
-rw-r--r-- | docs/windows-iis-installation.markdown | 40 |
2 files changed, 157 insertions, 9 deletions
diff --git a/docs/windows-apache-installation.markdown b/docs/windows-apache-installation.markdown new file mode 100644 index 00000000..25d39373 --- /dev/null +++ b/docs/windows-apache-installation.markdown @@ -0,0 +1,126 @@ +Installation on Windows Server and Apache +========================================= + +This guide will help you to setup step by step Kanboard on a Windows Server with Apache and PHP. + +Note: If you have a 64 bits platform choose "x64" otherwise choose "x86" for 32 bits systems. + +Visual C++ Redistributable Installation +--------------------------------------- + +PHP and Apache are compiled with Visual Studio so you need to install this library if it's not already done. + +1. Download the library from the [official Microsoft website](http://www.microsoft.com/en-us/download/details.aspx?id=30679) +2. Run the installer `vcredist_x64.exe` or `vcredist_x86.exe` according to your platform + +Apache installation +------------------- + +1. Download Apache binary from [Apache Lounge](http://www.apachelounge.com/download/) +2. Unzip the Apache24 folder to `C:\Apache24` + +### Define the server name + +Open the file `C:\Apache24\conf\httpd.conf` and add the directive: + +``` +ServerName localhost +``` + +### Install the Apache service + +Open a command prompt (`cmd.exe`) and go to the directory `C:\Apache24\bin`: + +```bash +cd C:\Apache24\bin + +# Install the windows service +httpd.exe -k install +``` + +### Install ApacheMonitor + +- Double click on `C:\Apache24\bin\ApacheMonitor.exe`, or put it in your startup folder. +- Right click on the icon and start Apache + +### Check the Apache installation + +Go to http://localhost/ you should see a blank page with the text "It works!". + +PHP installation +---------------- + +1. Download the last stable version of PHP from the [official PHP website](http://windows.php.net/download/), choose the **Thread Safe** version and use the exact same build type as Apache: x86 or x64 +2. Unzip the files to `C:\php` +3. Navigate to the PHP folder and rename the file `php.ini-production` to `php.ini` + +Edit the `php.ini`: + +Uncomment extension directory: + +```ini +extension_dir = "C:/php/ext" +``` + +Uncomment these PHP modules: + +```ini +extension=php_curl.dll +extension=php_gd2.dll +extension=php_ldap.dll +extension=php_mbstring.dll +extension=php_openssl.dll +extension=php_pdo_sqlite.dll +``` + +Set the timezone: + +```ini +date.timezone = America/Montreal +``` + +The list of supported timezones can be found in the [PHP documentation](http://php.net/manual/en/timezones.america.php). + +Load the PHP module for Apache: + +Add this configuration in the file `C:\Apache24\conf\httpd.conf`: + +``` +LoadModule php5_module "c:/php/php5apache2_4.dll" +AddHandler application/x-httpd-php .php + +# configure the path to php.ini +PHPIniDir "C:/php" + +# change this directive +DirectoryIndex index.php index.html +``` + +Restart Apache. + +Test your PHP installation: + +Create a file named `phpinfo.php` in the folder `C:\Apache24\htdocs`: + +```php +<?php + +phpinfo(); + +?> +``` + +Go to http://localhost/phpinfo.php and should see all information about your PHP installation. + +Kanboard installation +--------------------- + +- Download the zip file +- Uncompress the archive in `C:\Apache24\htdocs\kanboard` by example +- Open your web browser to use Kanboard http://localhost/kanboard/ +- The default credentials are **admin/admin** + +Tested configuration +-------------------- + +- Windows 2008 R2 / Apache 2.4.12 / PHP 5.6.8 diff --git a/docs/windows-iis-installation.markdown b/docs/windows-iis-installation.markdown index 2d16f2fc..84a2e53c 100644 --- a/docs/windows-iis-installation.markdown +++ b/docs/windows-iis-installation.markdown @@ -1,10 +1,10 @@ -How to install Kanboard on Windows Server? +Installation on Windows 2008/2012 with IIS ========================================== -Windows 2008/2012 with IIS ---------------------------- +This guide will help you to setup step by step Kanboard on a Windows Server with IIS and PHP. -### PHP installation +PHP installation +---------------- - Install IIS on your server (Add a new role and don't forget to enable CGI/FastCGI) - Install PHP by following the official documentation: @@ -12,7 +12,26 @@ Windows 2008/2012 with IIS - [Microsoft IIS 7.0 and later](http://php.net/manual/en/install.windows.iis7.php) - [PHP for Windows is available here](http://windows.php.net/download/) -After the installation check if PHP runs correctly: +Edit the `php.ini`, uncomment these PHP modules: + +```ini +extension=php_curl.dll +extension=php_gd2.dll +extension=php_ldap.dll +extension=php_mbstring.dll +extension=php_openssl.dll +extension=php_pdo_sqlite.dll +``` + +Set the timezone: + +```ini +date.timezone = America/Montreal +``` + +The list of supported timezones can be found in the [PHP documentation](http://php.net/manual/en/timezones.america.php). + +Check if PHP runs correctly: Go the IIS document root `C:\inetpub\wwwroot` and create a file `phpinfo.php`: @@ -30,17 +49,20 @@ If you got an error 500, something is not correctly done in your installation. Notes: - If you use PHP < 5.4, you have to enable the short tags in your php.ini -- Don't forget to enable the required php extensions: `pdo_sqlite` and `mbstring` +- Don't forget to enable the required php extensions mentioned above - If you got an error about "the library MSVCP110.dll is missing", you probably need to download the Visual C++ Redistributable for Visual Studio from the Microsoft website. -### Kanboard installation +Kanboard installation +--------------------- - Download the zip file - Uncompress the archive in `C:\inetpub\wwwroot\kanboard` by example - Make sure the directory `data` is writable by the IIS user -- You are done, open your web browser to use Kanboard +- Open your web browser to use Kanboard http://localhost/kanboard/ +- The default credentials are **admin/admin** -### Tested configuration +Tested configurations +--------------------- - Windows 2008 R2 Standard Edition / IIS 7.5 / PHP 5.5.16 - Windows 2012 Standard Edition / IIS 8.5 / PHP 5.3.29 |