wild-directory/ushahidi/versions/5/README.md

Ushahidi

Ushahidi is a crisis mapping and crowdsourcing platform for collecting, visualising, and analysing reports from a community.

Dependencies

• MySQL - Database for storing posts, surveys, and users
• Redis - Used for caching and background job queuing

Configuration

Key settings in config.yaml:

• domain - Where the Ushahidi web client will be accessible
• apiDomain - Where the Ushahidi API is accessible (default: ushahidi-api.{your-cloud-domain})
• storage - Persistent volume size (default: 2Gi)
• db.name - Database name (default: ushahidi)

First-Time Setup

1. Add and deploy the app:

   wild app add ushahidi
   wild app deploy ushahidi
   

2. Visit the client URL and complete the setup wizard to create your admin account and configure your deployment.

3. Start creating surveys and collecting reports from the public.

Notes

• Ushahidi has two components: the API (Laravel) and the Client (Angular) — both are deployed together and served on separate domains
• The Laravel API has a slow startup (~2 minutes) due to framework initialization — the deployment uses extended liveness probe delays to prevent restart loops
• The appKey is auto-generated in secrets.yaml and used for Laravel encryption