Arbit - project tracking

Arbit - project tracking

Revert wiki page

A wiki page with the requested title does not exist yet.

You do not have sufficant permissions to edit or create the wiki page.

========================
Arbit installation guide
========================

.. warning::
    This article is a stub, please help us extending it with more detailed information.

This document will help you to set up an arbit instance.

Prerequisite
============

The minimum prerequisite for installing arbit currently are:

- A webserver with PHP 5.3
- A running CouchDB__ instance, with the minimum version 0.8.1

__ http://incubator.apache.org/couchdb/downloads.html

Installation
============

There are two variants of installation. On a system supporting links, you
should probably chose the first one.

Linking
-------

Link the htdocs/ folder from arbit to your webroot itself or a subdirectory in 
your webroot.

Copying
-------

Copy the complete arbit instance ton one directory above your webroot and
configure your webserver to serve the htdocs/ folder from arbit as you webroot.

Some files from the folders above the actual htdocs/ directory, like the cache,
config and log files, should not be accessible from the web.

Webserver configuration
=======================

There are two ways to configure your webserver to get arbit working. Either
configure the index.php as your 404-error-handler, or rewrite all requests,
except for the images/ and styles/ directories to the index.php.

Apache example configuration
----------------------------

.. note::
    Please add.

Lighttpd example configuration
------------------------------

A lighttpd example configuration using a 404-error-handler could for example look like::

    $HTTP["host"] =~ "^arbit$" {
        var.localroot = vhostbase + "/arbit"
        server.document-root = localroot + "/htdocs/"

        server.error-handler-404 = "/index.php"
    }