Add installation instructions for Windows/Apache
This commit is contained in:
@@ -129,6 +129,7 @@ Documentation
|
|||||||
- [Installation on Centos](docs/centos-installation.markdown)
|
- [Installation on Centos](docs/centos-installation.markdown)
|
||||||
- [Installation on FreeBSD](docs/freebsd-installation.markdown)
|
- [Installation on FreeBSD](docs/freebsd-installation.markdown)
|
||||||
- [Installation on Windows Server with IIS](docs/windows-iis-installation.markdown)
|
- [Installation on Windows Server with IIS](docs/windows-iis-installation.markdown)
|
||||||
|
- [Installation on Windows Server with Apache](docs/windows-apache-installation.markdown)
|
||||||
- [Installation on Heroku](docs/heroku.markdown)
|
- [Installation on Heroku](docs/heroku.markdown)
|
||||||
- [Example with Nginx + HTTPS + SPDY + PHP-FPM](docs/nginx-ssl-php-fpm.markdown)
|
- [Example with Nginx + HTTPS + SPDY + PHP-FPM](docs/nginx-ssl-php-fpm.markdown)
|
||||||
|
|
||||||
|
|||||||
126
docs/windows-apache-installation.markdown
Normal file
126
docs/windows-apache-installation.markdown
Normal file
@@ -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
|
||||||
@@ -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 IIS on your server (Add a new role and don't forget to enable CGI/FastCGI)
|
||||||
- Install PHP by following the official documentation:
|
- 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)
|
- [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/)
|
- [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`:
|
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:
|
Notes:
|
||||||
|
|
||||||
- If you use PHP < 5.4, you have to enable the short tags in your php.ini
|
- 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.
|
- 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
|
- Download the zip file
|
||||||
- Uncompress the archive in `C:\inetpub\wwwroot\kanboard` by example
|
- Uncompress the archive in `C:\inetpub\wwwroot\kanboard` by example
|
||||||
- Make sure the directory `data` is writable by the IIS user
|
- 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 2008 R2 Standard Edition / IIS 7.5 / PHP 5.5.16
|
||||||
- Windows 2012 Standard Edition / IIS 8.5 / PHP 5.3.29
|
- Windows 2012 Standard Edition / IIS 8.5 / PHP 5.3.29
|
||||||
|
|||||||
Reference in New Issue
Block a user