Merge pull-request #526

docs/freebsd-installation.markdown

@@ -1,15 +1,15 @@
-Freebsd Installation
+FreeBSD 10 Installation
-====================
+=======================
 
-Freebsd 10
+Manual installation
-----------
+-------------------
 
 ```bash
-pkg update
+$ pkg update
-pkg upgrade
+$ pkg upgrade
 
 # Install PHP with some standard extensions
-pkg install wget unzip mod_php55 \
+$ pkg install wget unzip mod_php55 \
     php55-session php55-pdo_sqlite php55-pdo \
     php55-openssl php55-opcache php55-mbstring \
     php55-json php55-curl php55-mcrypt \
@@ -30,27 +30,140 @@ Zend Engine v2.5.0, Copyright (c) 1998-2014 Zend Technologies
 Enable Apache in your `/etc/rc.conf`:
 
 ```bash
-echo apache24_enable="YES" >> /etc/rc.conf
+$ echo apache24_enable="YES" >> /etc/rc.conf
 ```
 
-Setting up PHP for Apache, just add those lines into `/usr/local/etc/apache24/Includes/php.conf`:
+Set up PHP for Apache:
 
 ```bash
-AddType application/x-httpd-php .php
+$ echo "AddType application/x-httpd-php .php" >> /usr/local/etc/apache24/Includes/php.conf
-DirectoryIndex index.php index.html
+$ echo "DirectoryIndex index.php index.html" >> /usr/local/etc/apache24/Includes/php.conf
 ```
 
 Then start Apache:
 
 ```
-service apache24 start
+$ service apache24 start
 ```
 
 Install Kanboard:
 
 ```bash
-wget http://kanboard.net/kanboard-latest.zip
+$ cd /usr/local/www
-unzip kanboard-latest.zip
+$ wget http://kanboard.net/kanboard-latest.zip
-chown -R www:www kanboard/data
+$ unzip kanboard-latest.zip
-rm kanboard-latest.zip
+$ chown -R www:www kanboard/data
+$ rm kanboard-latest.zip
 ```
+Go to http://Your.server.dom.ain/kanboard and enjoy!
+
+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
+```
+
+Download and extract the latest version of kanboard port:
+
+```bash
+$ wget https://bitbucket.org/if0/freebsd-kanboard/get/tip.zip
+$ unzip tip.zip
+$ cd if0-freebsd-kanboard-*/kanboard
+```
+
+Choose proper type of the database (MySQL, Postgresql, SQLite), build port and install:
+```bash
+$ make config
+$ make install clean
+$ cd /usr/local/www/kanboard
+$ chown -R www:www data
+```
+
+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:
+
+```
+$ service apache24 start
+```
+
+Go to http://Your.server.dom.ain/kanboard and enjoy!
+
+Please note!
+------------
+
+FreeBSD port of kanboard is not yet a part of official FreeBSD ports tree.
+It has been commited for aprooval to be included in the repository. Details
+regarding the progress can be found [here](https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=196810).
+
+Port is being hosted on [bitbucket](https://bitbucket.org/if0/freebsd-kanboard/). Please feel free to comment,
+fork and suggest updates!
+
+PS.
+Once kanboard port is part of the FreeBSD ports tree the installation of kanboard will be even easier, something like:
+
+```bash
+$ pkg update
+$ pkg upgrade
+$ pkg install apache24 mod_php5 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:
+```
+$ service apache24 start
+```
+
+Go to http://Your.server.dom.ain/kanboard and enjoy!