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

Skip to end of metadata
Go to start of metadata

Please check for current install docs

  • No labels
    1. Copy appliication/config/database.php to application/config/environments/development/database.php
      The path application/config/environments/development/database.php is none existent after forking and cloning the project. Not sure where the developments folder is within the environments folder. I can only see a folder called "testing". Unless I am missing something, please advice. 

      Cheers (smile)
    1. Hey John,

      You just need to create an empty folder called development. I'll update the install instructions to reflect this soon.


  1. Hi what exactly do you mean by this "Install the database schema using migrations" and is this  "./minion --task=migrations:run --up" a command i should run in windows CMD or the apache CMD?

    1. The command on windows is slightly different. You'll need to run this at a windows cmd:

      php httpdocs/index.php --task=migrations:run --up


  2. I ran that command but its not recognized...

  3. are you on skype my id's Evans Gacheru

  4. Hi there,

    I have got everything running on my machine running OSX. My PHP version is 5.4, MySQL is 5.6 , Apache2. The server is serving up PHP pages with no issues except that when I run the last command ie. ./minion --task=migrations:run --up I get the following error on my terminal:

    ErrorException [ 1 ]: Call to undefined function mysql_connect() ~ MODPATH/database/classes/Kohana/Database/MySQL.php [ 59 ].

    Usually "Call to undefined function mysql_connect()" means that your mysql server is not communicating with your php module from my research. I have tried to create a simple php script connecting to a database in mysql and it works fine hence ruling out the problem with php-mysql lack of communication issues. Any insight will be greatly appreciated.


    1. When you tested mysql_connect in another script, was that run at the commandline or through apache? its possible you're getting the build in OSX php at the commandline, and a different version used by apache.

      Try running "php -m" at the commandline and check the mysql or mysqli module is enabled.

      Also - mysql_connect is deprecated soon (PHP 5.5 I think?) so you might need to use mysqli instead.. maybe copy paste your database config here for debugging?
      mine looks like this:

  5. Hello,

    I'm trying to run the MySQL migration comamnd on windows 7 machine but i got the error attached

    1. Where did you extra the code to?

      My guess is its not in c:\xampp\php\. I think xampp might use c:\xampp\htdocs in which case you would run:

      php c:\xampp\htdocs\lamu\httpdocs\index.php --task=migrations:run --up
      1. oooh, i forgot to right the full directory of the lamu which is c:\xampp\.....

        but now i did all the mentioned steps above and i try to run the application at http://localhost/lamu/httpdocs but nothing is working and i got server error 

        any guides to solve this problem


        1. If you're getting a 500 - I'd guess your apache config is breaking on something in the .htaccess file.

          Can you check the apache config has mod rewrite enabled? and that you have AllowOverride All set for the vhost?

          1. for the sake of simplicity and testing i have removed the .htaccess files and tried to run the application located in lamu/httpdocs/index.php


            nothing happened ,blank page

            i did all the steps mentioned above.


            do i need to install and configure kOHANA as well?

            1. For V3 to work you need either:
              1. the .htaccess mod rewrite rules working. (The blank page you're seeing is the basic HTML loading, but failing to load any JS/CSS/images after that because the rewrites are broken)
              2. you need to set 'index_file' in application/config/environments/development/init.php to 'index.php' .. this will include index.php before ALL V3 urls and avoid the need for url rewrites.

              1. i've gone with option 2.

                now when i run the app still no output except that the background turned into gray instead of white

                1. Are you running the latest release? or the latest code from the master branch? You'll need the code from master to support running without rewrites (option 2).

                  Can you give me some more debug info, whats the output in the JS console? what are you seeing if you view source? What do you see if you check the Network tab in the developer tools? (ie. which resources haven't loaded?)
                  This is still an alpha release, we don't have a lot of error checking so you'll have to digg to find error messages before I can help.

    • I'm running the latest code from the Master Branch


    1. I'm have the same problem, there is a solution?

  6. Hi!

    I'm trying to install ushahidi 3 on a debian server, but i'm have this problem:

    PHP Warning:  require(/var/www/lamu/system/classes/Kohana/Core.php): failed to open stream: No such file or directory in /var/www/lamu/application/bootstrap.php on line 16
    PHP Fatal error:  require(): Failed opening required '/var/www/lamu/system/classes/Kohana/Core.php' (include_path='.:/usr/share/php:/usr/share/pear') in /var/www/lamu/application/bootstrap.php on line 16


    do you know what is this?

    1. Sounds like you're missing all the submodules. If you clone the git repo you need to run "git submodule update --init --recursive"

      If you have any further issues please post a question on the forums.

  7. I have this error please help


        "errors": [
                "message": "Unable to find a route to match the URI: platform/httpdocs",
                "code": 404,
                "class": "Kohana_HTTP_Exception",
                "file": "/opt/lampp/htdocs/platform/vendor/kohana/core/classes/Kohana/Request.php",
                "line": 986,
                "trace": [
                        "file": "/opt/lampp/htdocs/platform/httpdocs/index.php",
                        "line": 29,
                        "function": "execute",
                        "class": "Kohana_Request",
                        "type": "->",
                        "args": []
  8. Just to precise:

    • You need ruby, but also ruby-dev install, otherwise you'll get something about extconf.rb make error
    • You need pupppet as well

    At least on ubuntu trusty & ruby 1.9.3

  9. I Have  a problem installing  the client>


    harold@harold-Lenovo-G40-70:/var/www/platform-client$ gulp build

    Error: Cannot find module 'esrecurse'
        at Function.Module._resolveFilename (module.js:338:15)
        at Function.Module._load (module.js:280:25)
        at Module.require (module.js:364:17)
        at require (module.js:380:17)
        at Object.<anonymous> (/var/www/platform-client/node_modules/jscs/node_modules/escope/lib/referencer.js:39:33)
        at Module._compile (module.js:456:26)
        at Object.Module._extensions..js (module.js:474:10)
        at Module.load (module.js:356:32)
        at Function.Module._load (module.js:312:12)
        at Module.require (module.js:364:17)
        at require (module.js:380:17)
        at Object.<anonymous> (/var/www/platform-client/node_modules/jscs/node_modules/escope/lib/index.js:79:34)
        at Module._compile (module.js:456:26)
        at Object.Module._extensions..js (module.js:474:10)
        at Module.load (module.js:356:32)
        at Function.Module._load (module.js:312:12)