FreeBSD Installation
=======================

.. warning::

    This page hasn't been updated for a while, and it's probably obsolete.

.. danger::  **Security**

    - Do not forget to change the default username/password.
    - Do not allow everybody to access the directory ``data`` from the URL.
    - Enable ``.htaccess`` if you use Apache (Option ``AllowOverride All``).
    - This is your responsability to configure your server correctly.

Package Installation
--------------------

.. code:: bash

    $ pkg upgrade -y
    $ pkg install -y apache24 mod_php56 kanboard

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

.. code:: bash

    $ sysrc apache24_enable=yes

Set up PHP for Apache:

.. code:: 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:

.. code:: bash

    $ service apache24 start

Add symlink to Kanboard folder into your Apache docroot:

.. code:: bash

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

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 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…

.. code:: bash

    $ portsnap fetch
    $ portsnap extract

or update already existing:

.. code:: 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:

.. code:: bash

    $ cd /usr/ports/www/apache24
    $ make install clean

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

.. code:: bash

    $ sysrc apache24_enable=yes

Install mod_php for Apache:

.. code:: bash

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

Install Kanboard form ports:

.. code:: bash

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

Set up PHP for Apache:

.. code:: 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:

.. code:: 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.

.. note:: Port is being hosted on `bitbucket <https://bitbucket.org/if0/freebsd-kanboard/>`__.
          Feel free to comment, fork and suggest updates!