Introduction About Habari What's New Installation Upgrading Using Habari Developer Introduction

# Installation

Habari has a few Server Requirements, which you will need to meet to be able to run Habari. If you have what is required, (or better), you are good to go! As Habari is still in development, no guarantees are made that these are fully stable versions, or that updating won't break the current database structure.

To install the latest stable version of Habari:

- Download the current release and unzip the Habari package.
- If you are using MySQL or PostgreSQL, obtain the connection settings needed below, or create a database for Habari on your web server.
- Upload Habari files on your web server.
- Point your web browser at http://yoursite.com/ (the location of your Habari files on your server) to begin installation with the Database Setup.

The Habari installer initially presents you with a choice of languages that it will use for the interface. Select the correct locale code from the list for your language of choice. The default selection is "en-us", which is English, United States.

Clicking the question mark at the top of any section of the installer will reveal more information about each field in that section.

Depending on the Database Type you set, you may need to enter some of the following information:

- Database Type: You can choose between MySQL, PostgreSQL, or SQLite. Your hosting company should be able to tell you what you should use.
- Database Host: Again your hosting company should have provided this information when you first joined.
- Username: This is the username used to connect Habari to the MySQL database.
- Password: This is the password used to connect Habari to the MySQL database.
- Database Name: Again your hosting company should have provided this information when you first joined.
- Table Prefix: You will only need to change this if you have more than one version of Habari installed.

After entering the required fields (those marked with an asterisk), the Check Database Connection button will become available. Click it to check that the connection details you just entered are correct. If they are, the next section of settings, Site Configuration, will become available.

The Site Configuration settings you will need to set are:

- Site Name: The name of your blog.
- Username: The name or alias you wish to use to administer your blog. This should not be the same as the username for the database.
- Password: The password associated with the above Username. Re-enter the password in the second box.
- Admin Email: This is the email address associated with the above Username. Habari will email you to let you know everything is working.

The next step of the installation procedure, Plugin Activation, becomes available after successfully entering the Site Configuration details.

Habari comes with several commonly used plugins. Some of these are marked for activation by default. In the Plugin Activation section you can choose not to activate any of these plugins, or choose others to also activate.

If you have already added other plugins to your Habari directories, these will also be in the list of plugins. You can choose to activate as many of these as you like during the installation.

Conclude the installation process by clicking the "Install Habari" button. When Habari completes processing, installation is complete.

The End! Habari should now be installed.

Full Installation Instructions are available, including some details of how to adjust your settings for different web servers and specific configuration information for several popular hosting companies.

If you are happy to use the current development version of Habari, the full instructions explain how to access the Habari subversion repository; however, for most normal users you will want to download the latest stable version of Habari.

## Common Installation Issues

There are a few common, yet easily-remedied issues that occur when installing Habari.

### Check Database Connection

After supplying the database credentials, Habari's installer will contact the server to test that it is able to connect to the database with the supplied values. On some systems, the following error appears:

> 404 Not Found Not Found The requested URL /blog/ajax/check_mysql_credentials was not found on this server.

There are several possible causes for this error:

1. Your Apache server does not have mod_rewrite enabled for the virtualhost that contains Habari. mod_rewrite is required for Habari to functions. Verify that mod_rewrite is installed and enabled on your server.
2. Your Apache configuration does not allow .htaccess to override configuration options in the virtualhost. The virtualhost in which Habari is installed should include the "AllowOverride FileInfo" directive for the directory that contains the Habari files. This will allow Habari's .htaccess file to properly handle incoming URLs. (Consult the AllowOverride documentation for further details on the AllowOverride directive.)