Export & import settings

When should I export settings?

Be prepared for the unforeseen. You might change important settings by accident and have problems to undo the changes. Your phone might break or get stolen. To easily return to status you’ve been at, settings should be exported on a regular basis.

Best practice is to export after change of settings or completing an objective.

Exported settings should be copied to a cloud storage or your computer. So you are prepared for loss or damage of your AAPS phone and do not have to start from zero.

On a Windows 10 computer it looks like this:

AndroidAPS Preferences phone connected to computer

Exported information

Among others the following information is part of the settings export:

Encrypted backup format

Settings backup is encrypted by a master password that can be set in Preferences .

Exportar definições

  • Hamburger menu (top left corner of screen)
  • Manutenção
  • Exportar configurações
AndroidAPS export settings 1
  • Date and time of export will be added to the file name automatically and displayed together with the path.
  • Click ‘OK’.
  • Enter master password and click ‘OK’.
  • Successful export will be prompted at bottom of the screen.
AndroidAPS export settings 2

Importar configurações

  • Hamburger menu (top left corner of screen)
  • Manutenção
  • Importar configurações
AndroidAPS import settings 1
  • All files from folder AAPS/preferences/ on your phone will be shown in the list.
  • Select file.
  • Confirm import by clicking ‘OK’.
  • Enter master password and click ‘OK’.
AndroidAPS import settings 2
  • Details on the preference file will be shown.
  • Last option to cancel import.
  • Click ‘Import’.
  • Confirm message by clicking ‘OK’.
  • AAPS will be restarted in order to activate imported preferences.

Note for Dana RS users

  • As pump connection settings are also imported AAPS on your new phone will already “know” the pump and therefore not start a bluetooth scan.
  • Please pair new phone and pump manually.

Import settings from previous versions (before AAPS 2.7)

  • The “old” settings file (called ‘AndroidAPSPreferences’ - without file extension) must be in root folder of your smartphone (/storage/emulated/0).
  • Do not put the “old” file in the same folder as the new exported settings (AAPS/preferences).
  • You will find the “old” file on the bottom of the list in the import dialogue.

Transfer settings file

  • Best way to transfer settings file to a new phone is via USB cable or cloud service (i.e. Google Drive).
  • Manuals can be found on the web, i.e. Android help pages.
  • If you experience problems with the transferred file try another way to transfer file.