summaryrefslogtreecommitdiff
path: root/doc/windows-apache-installation.markdown
blob: 27b6812eccf7eb28a6607febb0fdbbabb11b7e94 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
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).