// Collapsable Mobile Menus

Version Updates – is it Time?

Only if your mac is capable of running macOS Monterey.  If you can’t update your mac to Monterey, then DO NOT UPDATE TO iOS 15.4 or greater.

On 5/16/2022, Apple released iOS 15.5 and Xcode 13.4.

Version Compatibility

If you are using (or want to use) iOS 15.3 or greater, then …

  • Loop will only build using Loop (Workspace)
  • We recommend that you use the Build Select Script 
  • For more information, please read this important update in Loopdocs

iOS 15.5.x will only build using Xcode 13.4.x

  • Xcode 13.4.x requires macOS Monterey

iOS 15.4.x will only build using Xcode 13.3.x

  • Xcode 13.3.x requires macOS Monterey

iOS 15.3.x will only build using Xcode 13.2.x

  • Xcode 13.2.x requires macOS Big Sur 11.3 or greater, or Monterey

If you are using iOS 15.2.x or older, please check this site for version compatibility.

If you run into trouble trying to build Loop using the steps below, remember to use command+shift+3 to take screenshots of your error messages AND include detailed information about what went wrong and what steps you’ve taken.  


Settings Confirmation:

  • In iPhone settings, open the Loop or FreeAPS settings.
    • Make sure Bluetooth, Background App Refresh, and Cellular Data are turned on
    • If you have FreeAPS, make sure Adaptive Rate is turned off
  • In iPhone settings, open Dexcom
    • Make sure everything is on (four green sliders)
  • In iPhone settings, open Health
    • Click on “Data Access & Devices”
    • Ensure that Dexcom can write Blood Glucose
    • Ensure that Loop or FreeAPS has everything turned on except for Loop’s ability to Read Carbohydrates (six or seven green sliders depending on your version)
  • If you had to change anything in your iPhone settings, force close the Loop app and force reboot the phone
  • In iPhone settings, go to General / Software Update / Automatic Updates
    • Turn off “Automatic Updates”
    • You never want your Loop phone to auto-update the iOS version


Turn off auto-update


You never want your Loop phone to auto-update the iOS version. If you have not already done so, do this now:


  1. In iPhone Settings, go to General / Software Update / Automatic Updates.
  2. Turn on “Automatic Downloads”
  3. Turn off “Automatic Updates”


Even if you have a good backup of your phone, it can be very difficult, sometimes impossible, to downgrade your phone once you upgrade the iOS.

It’s a good idea to do the same on your computer.  Both the operating system and Xcode should have auto-update turned off. But please, update as soon as the all-clear is sounded.  Updates can provide very important security fixes as well as nifty new features.


More Information

You should always be in a position to build Loop, if necessary. The best practice is to upgrade your build computer (Mac) before upgrading the iOS on your iPhone.  Of course, that’s your choice.


Bookmark this page!  Come back when you have a version question in the future.

This page will be kept up-to-date as new versions are released.  You can also sign up for the newsletter, but to keep from spamming people, new version updates may not always be included in the newsletter, especially if it is for a minor version update.  So, this page is going to be your best “one-stop shop” to answer the general question.



Skip to content