summaryrefslogtreecommitdiff
path: root/doc/requirements.markdown
blob: 9943465a6c0aa1bb5a53d6f631c5143ba7989a1b (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
Requirements
============

Server side
-----------

### Compatible Operating Systems

| Operating System                     |
|--------------------------------------|
| Linux Ubuntu Xenial Xerus 16.04 LTS  |
| 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                       |                               |
| ctype                      |                               |
| session                    |                               |
| ldap                       | Only for LDAP authentication  |
| Zend OPcache               | Recommended                   |

### Optional PHP extensions

| PHP Extensions required    | Note                                       |
|----------------------------|--------------------------------------------|
| zip                        | Used to install plugins from Kanboard      |

### 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.