FOR ARCHIVAL PURPOSES ONLY

The information in this wiki hasn't been maintained for a good while. Some of the projects described have since been deprecated.

In particular, the "Ushahidi Platform v3.x" section contains information that is often misleading. Many details about this version of Platform have changed since.

This website is an extraction of the original Ushahidi wiki into a static form. Because of that, functions like logging in, commenting or searching will not work.

For more documentation, please refer to https://docs.ushahidi.com

Versions Compared

Old Version 8

changes.mady.by.user Robbie Mackay

Saved on

compared with

New Version Current

changes.mady.by.user Robbie Mackay

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migrated to Confluence 4.0

Checklist

Before beginning to install Ushahidi, please check that your system meets the minimum system requirements to run the platform

Download and Extract Ushahidi

You can obtain the official release of the software from the download site.
Alternatively, you can get the latest development code from  GitHub (be sure to use "git clone --recursive git://github.com/ushahidi/Ushahidi_Web.git", github zip files downloads may be incomplete).
Older releases are listed on the downloads page.

To unzip/extract the archive on a typical Unix/Linux command line:

Code Block
tar -xvf Ushahidi_Web-xxxx.tar.gz

On Windows systems, you can use any of the available archiving utilities such as 7zip, WinRAR etc or other utility that you may prefer

Change file and directory permissions

Ensure the following directories and files are writable by your webserver

No Format
application/logs
application/cache
application/config
media/uploads
.htaccess

Database Setup

Ushahidi stores all its information in a database. Though the Kohana framework supports a variety of database platforms via its ORM architecture, Ushahidi uses MySQL. This section assumes that you already have MySQL database server installed

Setup the MySQL Database and User

  • Run the mysql command as the MySQL super user (i.e. root) as follows:
    Code Block
    mysql -u root -p
    You will be prompted for the password which you specified when installing MySQL server. However, some MySQL server installations (e.g. on CentOS) do not prompt the user to specify a password at installation time. Should this be the case that applies to you, simply run the mysql command without any arguments.
  • Create an empty Ushahidi database schema by running:
    Code Block
    sql
    CREATE DATABASE ushahidi;
  • Create the Ushahidi database user by running
    Code Block
    sql
    GRANT ALL ON ushahidi.* TO ushahidiuser@'localhost' IDENTIFIED BY 'ushahidipassword';
    Replace 'ushahidiuser' and 'ushahidipassword' with a username and password of your choice. If Ushahidi is not running on the same server as your MySQL database server, replace 'localhost' with the hostname or IP address of the server for the Ushahidi installation

NOTE: If your MySQL server installation does not have a root password, you may specify one my running the following command:

Code Block
mysqladmin -u root password

Installation Wizard