Welcome!

Thanks for using Ushahidi. We hope that you find the setup and installation process as smooth as possible. We have an active community so if you get stuck along the way, head over to the forums and get some help. In addition to the forums, we have a wiki with more detailed information about the platform.

System Requirements

1. A server with Unicode support.
2. MySQL version 5.0 or greater.
3. PHP version 5.2.3 or greater.
4. An HTTP Server. Kohana which Ushahidi is built upon is known to work with the following web servers: Apache 1.3+, Apache2.0+, lighttpd, and MS IIS.

Required Extensions

The follwing is a list of PHP extensions that must be installed on your server in order for Ushahidi to run properly.

1. PCRE must be compiled with –enable-utf8 and –enable-unicode-properties for UTF-8 functions to work properly.
2. iconv is required for UTF-8 transliteration.
3. mcrypt is required for encryption.
4. SPL is required for several core libraries.
5. mbstring which speeds up Kohana's UTF-8 functions.
6. MySQL which is required for database access.
7. IMAP which is required for email functionality.

Need to figure out what extensions you already have installed on your server? Here are instructions to do just that.

Preliminary Setup

Before installing Ushahidi you will need to give your server authority to write to certian files and folders. Please make sure the following files and folders are writable by your server:

• application/config/config.php
• application/config
• application/cache
• application/logs
• media/uploads
• .htaccess

The process of configuring file permissions is different for various opperating systems. Here are some helpful links about permissions for the Unix and Windows opperating systems.

Installation Guide

Ushahidi can be installed manually or via the web installer. The easiest way to install Ushahidi is to use the web installer as it takes you through everything step by step.

Web Installer

1. Upload the unpacked/unzipped Ushahidi files to your server.
2. Make sure the appropriate files are writable by your web server (see "Preliminary Setup" above).
3. Point your browser to the http://[Your Ushahidi URL]/installer and follow the step by step instructions.

Manual Installation

1. Upload the unpacked/unzipped Ushahidi files to your server.
2. Create a database and note the connection credentials.
3. Make sure the appropriate files are writable by your web server (see "Preliminary Setup" above).
4. Copy or rename ./application/config/database.template.php to ./application/config/database.php.
5. Edit database.php and provide it with your database credentials.
6. Copy or rename ./application/config/config.template.php to ./application/config/config.php.
7. Edit config.php and provide it with the appropriate values. The comments in the file will tell you exactly what to provide. In most cases, you won't need to change many of them.
8. Create the appropriate tables into your database by executing the sql statements in the following file: ./sql/ushahidi.sql
9. Browse to your site:
   • URL: http://[Your Ushahidi URL]/
   • Admin Area: http://[Your Ushahidi URL]/admin
   • User: admin
   • Password: admin

Please note: There are still more settings and configurations that you will still need to complete in order to get your instance fully opporational. More information about these settings can be found on our wiki.

Online Resources

For further references and documentation, head over to our wiki. Also, we encourage you to drop by our forums if you have any additional questions or concerns.