This is an old revision of the document!


After installing the mSupply Mobile app, you must do an initialisation of the data for the mSupply Store that the tablet is going to be used in.

On opening the mSupply Mobile app, the first screen looks as follows:

You must enter:

  • The correct URL for your mSupply Server, this uses HTTPS protocol for security, e.g. https://your organisation.msupply.org
  • Sync site name as configured on the Primary Server
  • Password for the sync site as configured on the Primary Server

Once you have entered the information, click “Connect” to start sync: Initialisation can take between 1 and 15 minutes, depending on the number of records on the server related to the site being synced. Once the server has found all the records to sync, mSupply Mobile will start pulling them adaptively between 20 and 500 records at a time depending on the connection speed. If connection is lost or you closed the app, you can resume sync where it stopped by entering the exact same details. It will start again from scratch if you get it wrong before getting it right again!

Logging in to the store

Once complete, you will be taken to the login screen. For guidance beyond here see the mSupply Mobile user guide.

When first syncing the new device the amount of records to sync may be large (say around 50,000). This could take hours to sync, especially over a poor internet connection. For this reason it is possible for you to limit how many months of transactions and stocktakes you want to include.

  1. Change the store Synchronisation type from collector to active or none to unlock editing custom fields
  2. Add a new line setting the Field label to syncMonths and the Field value to the number of months you wish to include
  3. To edit the custom field double-click on the line
  4. Change the store synchronisation type back to collector

Now whenever a sync is carried out the store will only sync transactions and stocktakes for the previous X months.



  • en/mobile/setup/device_side/initialise_store.1583717222.txt.gz
  • Last modified: 2020/03/09 01:27
  • by Administrator