You can find troubleshooting info on many pages in the wiki. This page is a collection of links to help you find the information to solve your problem.

Additional useful information might also be available in the FAQ.

AAPS app

Building & updating


  • Profile

    Error: Basal not aligned to hours

  • Pump - data from different pump

    Failure message: Data from different pump

  • Nightscout Client


Frequent bluetooth connection problems

This can happen with various pumps. Apart from excluding AAPS from any battery optimization, you can also exclude the system bluetooth app from battery optimization. This can help in some cases. Depending on the phone you use, you will find the bluetooth app differently.

Here are examples how to find them on specific android phones.

Pixel phones (stock android)

  • Go to the android settings, select “Apps”.

    Android Settings¦Apps

  • Select “See all apps”

    See all apps

  • On the menu on the right, select “Show system” apps.

    Show system apps

  • Now search and select the app “Bluetooth”.

    Bluetooth app

  • Click the “App battery usage” and select “Not optimized”.

    BT Battery optimization

Samsung phones

  • Go to the android settings, select “Apps”

  • On the icon that supposedly changes the sorting algorithm (1), select “Show system apps” (2).

    App Filter

    Show system apps

  • Now search the bluetooth app and select it to see its settings.

    Bluetooth App

  • Select “battery”.


  • Set it to “Not optimized”

    Not optimized