--- title: 'Start' --- {% include head.html %}
{% include breadcrumbs.html current=page.title %}

# Quick Start

Last updated: {{ site.time | date: '%d.%m.%Y' }}

## Download

You can get the latest stable release with the download link or directly on github. This will give you a fully functional application with an application, modules, and system directory.

Download latest Koseven.zip

## Installing

### By Download

Once downloaded, you should extract the Koseven application to a directory where the web server can access it. Going forward, we are going to assume you've extracted the application to the root directory of your webserver and configured your document root to be the public folder of Koseven such that `http://localhost/index.php` is pointing to the `index.php` file in the Koseven release.

### By Github

The source code for Koseven is hosted with GitHub. To install Koseven using the github source code first you need to install git. Visit http://help.github.com for details on how to install git on your platform. Use the following command to install Koseven from GitHub: `git clone https://github.com/koseven/koseven .`

## Configure

Before the application can be run, you will need to make a few changes to the application/bootstrap.php file. This file is the first one to be included by index.php and sets up most of the global options for the application.
Open `application/bootstrap.php` and make the following changes:

Set the default timezone for your application.

    // Example of changing timezone to Sao Paulo, Brazil
    date_default_timezone_set('America/Sao_Paulo');

Set the base_url in the KO7::init call to reflect the location of the koseven folder on your server relative to the document root.

    /**
     * Example of koseven's installation at /var/www/koseven and
     * Apache's DocumentRoot configured to /var/www/koseven/public
     */
     Kohana::init(array(
         'base_url' => '/',
     ));

List your trusted hosts. Open `application/config/url.php` and add regex patterns of the hosts you expect your application to be accessible from.

#### Hint:

Do not forget to escape your dots (.) as these are regex patterns. These patterns should always fully match, as they are prepended with ^ and appended with $.

    return array(
        'trusted_hosts' => array(
            'example\.org',
            '.*\.example\.org',
        ),
    );

Define a salt for the Cookie class.

    Cookie::$salt = 'some-really-long-cookie-salt-here';

Make sure the application/cache and application/logs directories are writable by the web server.

    sudo chmod -R a+rwx application/cache
    sudo chmod -R a+rwx application/logs

Make sure to use a unique salt for your application and never to share it. Take a look at the Cookies page for more information on how cookies work in Kohana. If you do not define a Cookie::$salt value, Kohana will throw an exception when it encounters any cookie on your domain.

Test your installation by opening `http://localhost/`
You should see the installation page. If it reports any errors, you will need to correct them before continuing.
Once your install page reports that your environment is set up correctly you need to either rename or delete install.php. Kohana is now installed and you should see the output of the welcome controller:

{% include promo.html %}
{% include footer.html %}