summaryrefslogtreecommitdiff
path: root/doc/en_US/windows-apache-installation.markdown
diff options
context:
space:
mode:
Diffstat (limited to 'doc/en_US/windows-apache-installation.markdown')
-rw-r--r--doc/en_US/windows-apache-installation.markdown130
1 files changed, 130 insertions, 0 deletions
diff --git a/doc/en_US/windows-apache-installation.markdown b/doc/en_US/windows-apache-installation.markdown
new file mode 100644
index 00000000..27b6812e
--- /dev/null
+++ b/doc/en_US/windows-apache-installation.markdown
@@ -0,0 +1,130 @@
+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-bit 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_gd2.dll
+extension=php_ldap.dll
+extension=php_mbstring.dll
+extension=php_openssl.dll
+extension=php_pdo_sqlite.dll
+```
+
+Set the time zone:
+
+```ini
+date.timezone = America/Montreal
+```
+
+The list of supported time zones 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
+- Decompress 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
+
+Notes
+-----
+
+- Some features of Kanboard require that you run [a daily background job](cronjob.markdown).