The cold chain features within Open mSupply allow you to:

  • View and manage temperature sensors
  • Import data from Berlinger Fridge-tag and Q-tag temperature loggers (Berlinger and the mSupply Foundation have been working together to make sure Berlinger temperature monitors are well supported in Open mSupply; you can read more here).
  • View logs and breach data from sensors
  • Receive notifications of temperature breach and temperature excursion events

Sensors can be assigned to a storage location, which then allows you to associate temperature logs and breaches with specific stock lines. You can also view historical data to check if your cold chain equipment is operating correctly and to check if your stock might have been affected by temperature variations.

If a temperature breach happens, then a notification is displayed on every page of Open mSupply as a warning to check potentially affected stock. Once the breach is acknowledged then the notification is no longer shown.

Open mSupply integrates with the android based Cold Chain application; simply configure your Cold Chain application to sync with the Open mSupply server address and configure a username and password. Temperature sensors, breaches and logs will then appear within Open mSupply.

The Cold Chain referred to here is the integration of the Cold Chain features within Open mSupply. There is separate documentation for the Android Cold Chain application.


To begin, enable the store preference for mobile: Uses Vaccine Module (see the store preferences documentation for how to do this).

Any users who are to view and manage the Cold Chain features should have the following permissions enabled:

  • Vaccines
    • View sensor details
    • Edit sensor location

See the user permissions documentation for more details.

Cold chain app integration

The Cold Chain application is able to sync data to a server. The server can be an instance of Open mSupply or mSupply.

To configure the integration, you will only need to configure a user and then you can update the Cold Chain application.

The user is a standard mSupply user, with the following configuration:

  • The default store assigned to the user is the store which the temperature data will be associated with
  • The store will need to be part of the site that Open mSupply is synchronising with. Have a look at the Settings section to see which site omSupply is syncing with, and then the Synchronisation screen to check that your site includes the correct store.
  • The user must have the omSupply permission of Cold chain API access (see below)

Cold chain API permission

From here, simply follow the steps in the Cold Chain application documentation for Integrating with mSupply Desktop