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

Skip to end of metadata
Comment: Migrated to Confluence 4.0
Go to start of metadata

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:

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

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:
    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:
  • Create the Ushahidi database user by running
    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:

Installation Wizard

  • No labels

3 Comments

Hide/Show Comments

  1. Chema

    Hi, I just tried to install Ushahili in my server. 

    After failing installing v3, I came back to version 2. In my laptop with Xampp everything went fine. But not in my online server provided by 1&1. 

    Apparently installation ran smoothly, but some PHP data is not showing correctly: check menu names (UI_***). In the admin panel is always like this.

    http://s284470333.mialojamiento.es/mappe/ushahidi_v2/

    What is happening? Maybe permissions? 

    Thanks!

     

    1. Vikram Gandhi

      Hi Chema,

      Go to https://github.com/ushahidi/Ushahidi-Localizations and download the localization package. Now just copy the language directory to \application\i18n\ folder.

      For example, copy the folder en_US to \applications\i18n folder on your server.

      Refresh your page and your labels would be fixed. You can copy other languages too. These will be available in admin->settings. You can then set a default language from there. 

  2. Vikram Gandhi

    Hi Chema,

    Go to https://github.com/ushahidi/Ushahidi-Localizations and download the localization package. Now just copy the language directory to \application\i18n\ folder.

    For example, copy the folder en_US to \applications\i18n folder on your server.

    Refresh your page and your labels would be fixed. You can copy other languages too. These will be available in admin->settings. You can then set a default language from there.