summaryrefslogtreecommitdiff
path: root/doc/freebsd-installation.markdown
blob: 7b36dff19ef36c2e6ae0fc854ebe46b60427cd7c (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
FreeBSD 10 Installation
=======================

Install from packages
---------------------

```bash
$ pkg update
$ pkg upgrade
$ pkg install apache24 mod_php56 kanboard
```

Enable Apache in your `/etc/rc.conf`:

```bash
$ echo apache24_enable="YES" >> /etc/rc.conf
```

Set up PHP for Apache:

```bash
$ echo "AddType application/x-httpd-php .php" >> /usr/local/etc/apache24/Includes/php.conf
$ echo "DirectoryIndex index.php index.html" >> /usr/local/etc/apache24/Includes/php.conf
```

Then start Apache:

```bash
$ service apache24 start
```

Add symlink to Kanboard folder into your Apache docroot:

```bash
cd /usr/local/www/apache24/data
ln -s /usr/local/www/kanboard
```

Go to http://your.server.domain.tld/kanboard and enjoy!

*Notes*:
- If you want to use additional features like LDAP integration etc.
please install proper PHP module using pkg.
- You may have to adjust the permissions of the folder data

Installing from ports
---------------------

Generally 3 elements have to be installed:

- Apache
- mod_php for Apache
- Kanboard

Fetch and extract ports...

```bash
$ portsnap fetch
$ portsnap extract
```

or update already existing:

```bash
$ portsnap fetch
$ portsnap update
```

More details regarding portsnap can be found in the [FreeBSD Handbook](https://www.freebsd.org/doc/handbook/ports-using.html).

Install Apache:

```bash
$ cd /usr/ports/www/apache24
$ make install clean
```
Enable Apache in your `/etc/rc.conf`:

```bash
$ echo apache24_enable="YES" >> /etc/rc.conf
```

Install mod_php for Apache:

```bash
$ cd /usr/ports/www/mod_php5
$ make install clean
```

Install Kanboard form ports:

```bash
$ cd /usr/ports/www/kanboard
$ make install clean
```

Set up PHP for Apache:

```bash
$ echo "AddType application/x-httpd-php .php" >> /usr/local/etc/apache24/Includes/php.conf
$ echo "DirectoryIndex index.php index.html" >> /usr/local/etc/apache24/Includes/php.conf
```

Then start Apache:

```bash
$ service apache24 start
```

Go to http://your.server.domain.tld/kanboard and enjoy!

*Note*:
If you want to use additional features like LDAP integration etc.
please install proper PHP module from `lang/php5-extensions`.

Manual installation
-------------------

As of version 1.0.16 Kanboard can be found in FreeBSD ports
there is no need to install it manually.

Please note
-----------

- Port is being hosted on [bitbucket](https://bitbucket.org/if0/freebsd-kanboard/). Feel free to comment,
fork and suggest updates!
- Some features of Kanboard require that you run [a daily background job](cronjob.markdown).