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, better two different locations. 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:

AAPS Preferences phone connected to computer

Export Path

The exports will be placed in this folder on your phone:

/Internal Storage/AAPS/preferences

This storage location cannot be changed in the AAPS settings.

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 .

Export settings

  • Hamburger menu (top left corner of screen)

  • Maintenance

  • Export settings

AAPS 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.

AAPS export settings 2

Import settings

Do not import settings while on an active Pod session - see Omnipod page for details.

  • Hamburger menu (top left corner of screen)

  • Maintenance

  • Import settings

AAPS 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‘.

AAPS 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.