mUzima comes with an initial setup wizard to aid in setup and configuration. During the configuration process, a number of resources are downloaded from OpenMRS instance for use during actual use of the application. These resources include Cohorts (List of patient records), Forms, Concepts, Forms, Encounters and Observations.

The configuration process is executed only once when the app is first launched, but in case of interruption the setup process will be restarted.

Once you have downloaded and installed mUzima as indicated here, follow the steps below to it set up

Step 1: Launch the app and specify the following three (3) required variables at the login page:

URL

username

password

The app comes with default URL pointing to mUzima demo server (http://demo2.muzima.org) that can be accessed with the credentials (username: admin, password: test)

Step 2: Upon successful login, there are two methods of continuing the setup - Guided configuration and Advanced setup method

For Guided configuration, the app uses configuration information created at server side that specifies all relevant resources to be downloaded. For example, this is useful for implementations that have many users who want to download the same set of resources from server side, and therefore provides a convenient way for specifying what exactly to download. To use Guided configuration, choose a configuration and go next. (As of version 2.0, only one configuration can be selected)