Upgrading from V3.x.x to V4.x.x

In September 2018, we updated the Platform api, removed Kohana (mostly) and started using Lumen. This affects some of the setup and commands used in the api.

Migration guide


Please ensure that you are using a supported version of PHP for the version of platform that you are running.
  • v2 supports up to PHP 5.4
  • v3 supports PHP 5.6 and 7.0
  • v4.0.0 supports PHP 7.0 to 7.2
  • v4.1.0+ supports PHP 7.1 to 7.3 (inclusive). This change was made to ensure we support versions of PHP that are getting security fixes at the very least. See PHP maintenance schedules here.
  • v4.4.0+ supports PHP 7.2 and 7.3 (inclusive). This is, again, according to PHP 7.1 scheduled End-Of-Life.

Database config changes

The database configuration vars have been renamed.
Old var
New var

New Configuration keys

Supported options are array, redis and memcached. Read more about Lumen's cache configuration and options here https://lumen.laravel.com/docs/5.4/cache


bin/ushahidi will be deprecated in future versions. You should use artisan instead.

Command name changes

CLI commands have been renamed. If you had cronjobs set up to run dataproviders, etc you will need to update those
Old command
New command
bin/ushahidi dataprovider incoming
artisan datasource:incoming
bin/ushahidi savedsearch
artisan savedsearch:sync
bin/ushahidi notification queue
artisan notification:queue
bin/ushahidi dataprovider outgoing
artisan datasource:outgoing
bin/ushahidi dataprovider webhook send
artisan webhook:send
bin/ushahidi user create
artisan user:create
bin/ushahidi user delete
artisan user:delete
bin/ushahidi config get
artisan config:get
bin/ushahidi config set
artisan config:set
bin/ushahidi export
artisan export
bin/ushahidi import
artisan import

Filesystem changes

Uploaded files have moved from application/media/upload to storage/app. You should move any existing files to the new location.
If you used a CDN for file storage, you should configure the FILESYSTEM_DRIVER variable in your .env file. Then review config/filesystems.php to find the other config parameters, the old CDN_... params have be renamed.

Old configuration files

Old configuration files in application/config are now obsolete. These are not either located in config/, or configured through environment vars (ie. .env)

Platform Client

To use this version of the platform API, you will need to update your version of the platform-client to use the same release version.