Version Updates

For information about updates to Apple OS and Xcode versions, as well as Loop and Trio, click the links below:

• Updating your phone’s iOS
  • iOS/Apple Updates
  • Special Information for Mac-Xcode Builders
• Update your OS-AID (Open Source Automated Insulin Delivery system)
  • Loop Updates
    • Loop Customization Updates
  • Trio Updates

Loopers should not update to any beta version of iOS, macOS or Xcode.  There are no features in the beta version of any software that are more important than your ability to manage insulin delivery from your phone/medical device.  

Loop-dev

There are no differences between dev and main at this time.

iOS / Apple Updates

We recommend that all loopers treat their phone as a medical device.  Please exercise caution when updating your phone’s iOS, especially for a major update such as iOS 18 to 26.  Minor updates are typically less problematic, but we test every update to be sure.  Auto updates should be off.

Turn off auto-update

Do not set your Loop phone to auto-update its iOS version 

In iPhone Settings, go to General / Software Update / Automatic Updates.

1. Turn on “Automatic Downloads”
2. Turn off “Automatic Updates”

Once you upgrade the iOS, it can be very difficult (sometimes impossible) to downgrade.

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.

iOS versions

We recommend iOS 18.7.x for all Loop and Trio users.
We Do Not Recommend iOS 26.x. 

There are a few special warnings for loopers who must update to iOS 26.x (for whatever reason):

• Loopers must build Loop 3.8.x (main) or 3.9.x (dev). 
• Trio users should NOT UPDATE TO iOS 26.1.

Mac-Xcode Builders Only

How to build Loop to an iOS 18.x or higher phone

1. Update your macOS to the latest it can support (macOS 15.4.1 or higher is preferred)
2. Download Xcode 16.4 or newer, but not Xcode 26 yet
3. Use the Build Select Script to download fresh Loop or Trio code and rebuild

If you find that your macOS won’t update, then a Browser Build is for you.

Developer Mode

This has gotten more complicated recently. Please refer to the LoopDocs write-up on Developer Mode.

What are the latest “tested” versions?

The Versions of macOS and Xcode that you need are based on your phone’s iOS.  These Versions have been tested to operate and build both the main and dev branches of Loop, LoopFollow, LoopCaregiver, and Trio.  This table includes the latest tested versions of iOS, along with the compatible minimum Xcode and macOS versions.  Loopers should not update to any beta versions.

Loop Updates

• Mac-Xcode builders – use the Build Select Script to build main       
  
• Browser Builders – make sure your default branch is main.  We do not know why, but GitHub is disabling the Build Loop Action for LoopWorkspace forks.  You will need to manually Sync Fork, Enable the Build workflow, and Build Loop.
• If you need help, please ask on Facebook or Zulip

Loop Recent Release History

• Loop 3.8.2 was released on 31 October 2025; see details here.
  • Fixes designed behavior of tapping on the bolus line should automatically replace the recommended value with zero, which stopped working after changes were made to this interface to accommodate iOS 26
  • Warning for Dana users – this version does not support Dana but 2 alternate branches are available. 
• Loop 3.8.1 was released on 23 September 2025; see details here.
  • Fixes designed behavior of tapping on the bolus line should automatically replace the recommended value with zero, which stopped working after changes were made to this interface to accommodate iOS 26
  • DanaKit and other updates
• Loop 3.8 was released on 14 September 2025 ; see details here.
  • Adds support for Dana-i and DanaRS-v3 pump models
  • Updates translations and convert to String Catalogs
  • Supports iOS 26
• Loop 3.6.4 was released on 31 July 2025; see details here.
  This release:
  • Provides support for newer European Libre 2 plus sensors (mid 2025 Libre 2 plus EU sensors)
  • Adds localization to the LibreTransmitter module
  • Adjusts build dependencies for G7SensorKit (no functional change)
  • Shifts the automatic build time from hh:00 to hh:33
    • Automatic builds have been running into errors recently
    • This time shift avoids a time when GitHub resources are impacted
• Loop 3.6.3 was released on 10 July 2025; see details here.
  This release fixes a rare IOB-counting bug 

Loop Customization Updates

• When updating from Loop 3.4.4 (released 12-October 2024), to Loop 3.6.0 (released on 23-April-2025) or later:
  • Browser Build users must remove 2 customizations from their build_loop.yml files: “bolus_display” and “g7_scan”. Both of these customizations are included in Loop 3.6.0. If you leave them in, your build will fail. Be sure that the last customization you have in your build_loop.yml file does not end with a continuation character. If those directions are not clear for you, please ask for help.
  • Users of the Dana pump – Browser Builders – please modify your build_loop.yml file to use the new version of the pump addition found at this link.

Trio Updates

If you need help, please ask on Facebook or Discord.

Trio Release History

• Trio 0.6.0 was released on 6-October-2025; see details here.
  • Display latest dev version in Settings for non-main builds 
  • Add steps in Onboarding for uploading to Nightscout
  • Add toggle for external insulin in Shortcut Action
  • Implement APNS feedback for Remote Commands
• Trio 0.5.1 was released on 25-June-2025; see details here.
• Trio 0.5.0 was released on 16-May-2025; see details here.
  • Automation added to detect invalid or expired certificates and create new ones
    Requires addition of a Variable

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!  {DO THIS NOW!} 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 new version updates may not always be included in the newsletter.  This page is your best “one-stop shop” to answer general questions about versions and compatability.