Troubleshooting
Start here when something is not working. Troubleshooting information lives on many pages across the documentation. This page brings it together: it is a single collection of links, sorted by topic, to help you solve the most common problems.
If you do not find your answer below, also check:
the FAQ for answers to frequent questions, and
the Profile tuning guide if your loop runs but your glucose control needs improving.
Still stuck?
If none of the links solve your problem, see Where can I get help to ask the community (Facebook, Discord), or send your log files to the developers.
AAPS app
Building & updating
If the build fails, see If the build fails: it lists the troubleshooting section for each build method:
Lost keystore, or new keystore: Reinstalling AAPS
Updating AAPS: with AAPS Builder, with a browser build (fork), with Android Studio
Installing
Google Play Protect warning: the app is reported as unsafe.
Installation blocked with a message about an unverified developer: see Android developer verification for the free installation methods.
Settings
Profile: “Basal rate is not compatible with the current pump”
“AAPS settings cannot be read” at start: the settings are encrypted with a key that Android keeps for AAPS, and that key does not open them any more, for example after the key store of the phone was reset. While this screen is shown, AAPS is not running and does not control the pump. Tap Retry: it closes and restarts AAPS. If that does not help, restart the phone. Use Start fresh only when nothing else helps: it sets the unreadable settings file aside (it is renamed and kept) and starts AAPS with empty settings. Then import your last settings export.
Usage
Android Related Issues
Battery optimization
AAPS can help you find the right settings for your phone: open the menu (☰) > About and tap Don’t kill my app?. It opens the instructions for your phone brand on Don’t kill my app. The setup wizard also asks you to turn off battery optimization for AAPS and Bluetooth.
Android has implemented battery saving setting that are enabled by default. These settings automatically suspend/pause applications that are not required for the system to function to help conserve the amount of battery energy used by apps that don’t always need to be running.
When this is enabled, it will very likely cause issue for AAPS and other supporting apps like xDrip.
It’s important to ensure that you have disabled Battery Optimization to ensure AAPS and other supporting apps remain active all the time.
Depending on your phone model and make there may be more than one location and setting which needs to have this disabled.
NOTE: Follow the steps below to Disable Battery Optimization for the Bluetooth service if your phone has this option, the same steps can be used to disable for AAPS and other apps, however the screenshots will only show how to do this for the Bluetooth service.
Pixel phones (stock Android)
Go to the Android settings, select “Apps”.
Select “See all apps”
On the menu on the right, select “Show system” apps.
Now search and select the app “Bluetooth”.
Click the “App battery usage” and select “Unrestricted” (called “Not optimized” on some older Android versions).
Samsung phones
Go to the android settings, select “Apps”
On the icon that supposedly changes the sorting algorithm (1), select “Show system apps” (2).
Now search the Bluetooth app and select it to see its settings.
Select “battery”.
Set it to “Unrestricted” (called “Not optimized” on some older Android versions).
Huawei phones
See this guide for Huawei Bluetooth & battery optimization
Continuous Glucose Monitor (CGM)
Useful links to known issues and steps to resolve for CGMs.
Pumps
Useful links to known issues and steps to resolve for Pumps
Phones
Useful links to known issues and steps to resolve for Phones
Remote control
Smartwatches
Useful links to known issues and steps to resolve for Smartwatches