Arbit - project tracking

Arbit installation guide

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

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/, styles/ and scripts/ directories to the index.php.

Arbit may reside inside some subdirectory like http://example.org/arbit/ or directly in the vhost root, like http://example.org. Both should be handled properly by arbit itself.

Apache example configuration

You can configure arbit to either reside in the vhost root, or in some subdirectory. A .htaccess files with the required rewrite rules is provided in the htdocs/ directory. The rewrite rules should look like:

RewriteEngine On

RewriteRule images/.* $0 [L]
RewriteRule styles/.* $0 [L]
RewriteRule scripts/.* $0 [L]
RewriteRule .* index.php [L,QSA]

Everything else should just work like known from apache.

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"
}

You may also use rewrite rules with lighttpd, like with apache. The configuration then would look like:

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

    url.rewrite-once = (
        "^/(?:images|styles|scripts)/.*" => "$0",
        "^/.*" => "index.php",
    )
}

If your arbit installation resides in some subdirectory you should modify the rewrite rules accordingly.