Getting Started

Here you will find the necessary steps to install and initial configure the rapidsms-healthcare application.


rapidsms-healthcare requires Python 2.6 or 2.7. Python 3 is not currently supported but is planned in the future as Django and RapidSMS support for Python 3 increases. It also requires the following packages:

  • Django >= 1.4
  • RapidSMS >= 0.11.0


Stable releases of rapidsms-healthcare can be found on PyPi and pip is the recommended method for installing the package:

pip install rapidsms-healthcare


The storage and retrieval of healthcare related data is configured by the HEALTHCARE_STORAGE_BACKEND setting. If you are using the default storage backend you need to change your INSTALLED_APPS to include:

    # Other apps go here

If you are using a different backend then you can skip this step. The Django backend uses South to manage possible future changes to the schema. While not required if you are using South in your project then you can create the tables needed for the backend via:

python migrate djhealth

If you are not using South then you can create the tables via:

python syncdb


While using South is optional, it is highly recommended. If you are not using South then you may need to apply future schema change yourself. When needed these will be noted in the release notes.

Next Steps

Project Versions

Table Of Contents

Previous topic

Project Overview

Next topic

Basic Usage

This Page