summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorFrederic Guillot <fred@kanboard.net>2016-01-08 21:44:51 -0500
committerFrederic Guillot <fred@kanboard.net>2016-01-08 21:44:51 -0500
commit97270f9b1897e2228516e2edfa927d2c0ca17c75 (patch)
tree6d95eebbe1437f11c36ed8451a89b217a6b1a0a0
parentf32d23d01528f86ff25728e9a99058e273d5b154 (diff)
Improve requirements page in documentation
-rw-r--r--doc/index.markdown2
-rw-r--r--doc/installation.markdown8
-rw-r--r--doc/recommended-configuration.markdown36
-rw-r--r--doc/requirements.markdown101
-rw-r--r--doc/windows-apache-installation.markdown1
-rw-r--r--doc/windows-iis-installation.markdown1
6 files changed, 103 insertions, 46 deletions
diff --git a/doc/index.markdown b/doc/index.markdown
index 953dc72f..1e95fe06 100644
--- a/doc/index.markdown
+++ b/doc/index.markdown
@@ -87,7 +87,7 @@ Technical details
### Installation
-- [Recommended configuration](recommended-configuration.markdown)
+- [Requirements](requirements.markdown)
- [Installation instructions](installation.markdown)
- [Upgrade Kanboard to a new version](update.markdown)
- [Installation on Ubuntu](ubuntu-installation.markdown)
diff --git a/doc/installation.markdown b/doc/installation.markdown
index d51c0e52..b208be8a 100644
--- a/doc/installation.markdown
+++ b/doc/installation.markdown
@@ -1,13 +1,7 @@
Installation
============
-Requirements
-------------
-
-- Apache or Nginx
-- PHP >= 5.3.3 (Kanboard is compatible with PHP 5.3, 5.4, 5.5, 5.6 and 7.0)
-- PHP extensions required: mbstring, gd and pdo_sqlite
-- A modern web browser
+Firstly, check the [requirements](requirements.markdown) before to go further.
From the archive (stable version)
---------------------------------
diff --git a/doc/recommended-configuration.markdown b/doc/recommended-configuration.markdown
deleted file mode 100644
index dccbc81d..00000000
--- a/doc/recommended-configuration.markdown
+++ /dev/null
@@ -1,36 +0,0 @@
-Recommended Configuration
-=========================
-
-Server side
------------
-
-- Modern Linux/Unix operating systems: **Ubuntu/Debian or FreeBSD**
-- The most recent version of PHP and Apache (Kanboard is compatible with PHP 5.3, 5.4, 5.5, 5.6 and 7.0)
-- Use Sqlite database only when you have a disk with fast I/O (SSD disks) otherwise use Mysql or Postgresql
-
-Client side
------------
-
-- Use a modern browser: **Mozilla Firefox or Google Chrome or Safari**
-
-Tested configurations
----------------------
-
-The following configurations are tested with Kanboard but that doesn't mean all features are available:
-
-### Server
-
-- Ubuntu 14.04 LTS
-- Debian 6, 7 and 8
-- Centos 6.x and 7.0
-- Windows 2012 Server
-- Windows 2008 Server
-
-### Desktops
-
-- Last version of Mozilla Firefox, Safari and Google Chrome
-- Microsoft Internet Explorer 11
-
-### Tablets
-
-- iPad mini 3
diff --git a/doc/requirements.markdown b/doc/requirements.markdown
new file mode 100644
index 00000000..2c99d4f2
--- /dev/null
+++ b/doc/requirements.markdown
@@ -0,0 +1,101 @@
+Requirements
+============
+
+Server side
+-----------
+
+### Compatible Operating Systems
+
+| Operating System |
+|--------------------------------|
+| Linux Ubuntu Trusty 14.04 LTS |
+| Linux Centos 6.x |
+| Linux Centos 7.x |
+| Linux Redhat 6.x |
+| Linux Redhat 7.x |
+| Linux Debian 8 |
+| FreeBSD 10.x |
+| Microsoft Windows 2012 R2 |
+| Microsoft Windows 2008 |
+
+### Compatible Databases
+
+| Database |
+|--------------------|
+| Sqlite 3.x |
+| Mysql >= 5.5 |
+| MariaDB >= 10 |
+| Postgresql >= 9.3 |
+
+Which database to choose?
+
+| Type | Usage |
+|-----------------|-----------------------------------------------------|
+| Sqlite | Single user or small team (almost no concurrency) |
+| Mysql/Postgres | Larger team, high-availability configuration |
+
+Do not use Sqlite on NFS mounts, use Sqlite only when you have a disk with fast I/O
+
+### Compatible Web Servers
+
+| Web Server |
+|--------------------|
+| Apache HTTP Server |
+| Nginx |
+| Microsoft IIS |
+
+Kanboard is pre-configured to work with Apache (URL rewriting).
+
+### PHP Versions
+
+| PHP Version |
+|----------------|
+| PHP >= 5.3.3 |
+| PHP 5.4 |
+| PHP 5.5 |
+| PHP 5.6 |
+| PHP 7.x |
+
+### PHP Extensions Required
+
+| PHP Extensions required | Note |
+|----------------------------|-------------------------------|
+| pdo_sqlite | Only if you use Sqlite |
+| pdo_mysql | Only if you use Mysql/MariaDB |
+| pdo_pgsql | Only if you use Postgres |
+| gd | |
+| mbstring | |
+| openssl | |
+| json | |
+| hash | |
+| ldap | Only for LDAP authentication |
+| Zend OPcache | Recommended |
+
+### Recommendations
+
+- Modern Linux or Unix operating system.
+- Best performances are obtained with the latest version of PHP with OPcode caching activated.
+
+Client side
+-----------
+
+### Browsers
+
+Always use a modern browser with the latest version if possible:
+
+| Browser |
+|---------------------------------------|
+| Safari |
+| Google Chrome |
+| Mozilla Firefox |
+| Microsoft Internet Explorer >= 11 |
+| Microsoft Edge |
+
+### Devices
+
+| Device | Screen resolution |
+|-------------------|--------------------|
+| Laptop or desktop | >= 1366 x 768 |
+| Tablet | >= 1024 x 768 |
+
+Kanboard is not yet optimized for smartphones. It's working but the user interface is not really convenient to use.
diff --git a/doc/windows-apache-installation.markdown b/doc/windows-apache-installation.markdown
index 565fe94f..2c8f74e1 100644
--- a/doc/windows-apache-installation.markdown
+++ b/doc/windows-apache-installation.markdown
@@ -65,7 +65,6 @@ 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
diff --git a/doc/windows-iis-installation.markdown b/doc/windows-iis-installation.markdown
index 960f903f..6206db21 100644
--- a/doc/windows-iis-installation.markdown
+++ b/doc/windows-iis-installation.markdown
@@ -15,7 +15,6 @@ PHP installation
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