Skip to content
Ushahidi is a platform that allows information collection, visualization and interactive mapping, allowing anyone to submit information through text messaging using a mobile phone, email or web form.
Branch: master
Clone or download
Pull request Compare This branch is 881 commits ahead, 2778 commits behind ushahidi:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


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
- A server with Unicode support.
- MySQL version 5.0 or greater.
- PHP version 5.2.3 or greater.
- 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.
- PCRE ( must be compiled with –enable-utf8 and –enable-unicode-properties for UTF-8 functions to work properly.
- iconv ( is required for UTF-8 transliteration.
- mcrypt ( is required for encryption.
- SPL ( is required for several core libraries
- mbstring ( which speeds up Kohana's UTF-8 functions.
- cURL ( which is used to access remote sites.

* 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 operating systems. Here are some helpful links about permissions for the Windows ( and Unix ( operating 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
	- Upload the unpacked/unzipped Ushahidi files to your server.
	- Make sure the appropriate files are writable by your web server (see "Preliminary Setup" above).
	- Point your browser to the http://[Your Ushahidi URL]/installer and follow the step by step instructions.

	Manual Installation
	- Upload the unpacked/unzipped Ushahidi files to your server.
	- Create a database and note the connection credentials.
	- Make sure the appropriate files are writable by your web server (see "Preliminary Setup" above).
	- Copy or rename ./application/config/database.template.php to ./application/config/database.php.
	- Edit database.php and provide it with your database credentials.
	- Copy or rename ./application/config/config.template.php to ./application/config/config.php.
	- 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.
	- Create the appropriate tables into your database by executing the sql statements in the following file: ./sql/ushahidi.sql
	- 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.
You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.