From 97270f9b1897e2228516e2edfa927d2c0ca17c75 Mon Sep 17 00:00:00 2001 From: Frederic Guillot Date: Fri, 8 Jan 2016 21:44:51 -0500 Subject: Improve requirements page in documentation --- doc/index.markdown | 2 +- doc/installation.markdown | 8 +-- doc/recommended-configuration.markdown | 36 ----------- doc/requirements.markdown | 101 +++++++++++++++++++++++++++++++ doc/windows-apache-installation.markdown | 1 - doc/windows-iis-installation.markdown | 1 - 6 files changed, 103 insertions(+), 46 deletions(-) delete mode 100644 doc/recommended-configuration.markdown create mode 100644 doc/requirements.markdown (limited to 'doc') 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 -- cgit v1.2.3