Some eagle-eyed users of Burp Suite have noticed that there is no Mac release of Burp Suite 2021.10.2.

Why is this release missing in action? Well, the true story is rather mundane, and unfortunate.

For a long time, Burp has been distributed via platform-specific installers. We finally got around to using the modern archive-based process on Macs, and 2021.10.2 was the first release to use this system.

As well as making up-front installation smoother, archive distributions work a bit differently when an update happens. Whereas an installer-based update replaces specific files within the application folder, an archive-based update replaces the whole folder and everything in it.

As it happened, the problem turned out to be really rather elementary. We hadn’t anticipated that some users were actually saving Burp project files within their application folder. This didn’t cause any problems when updates were installer-based, because only the relevant Burp files were updated. But when we changed to using archives … boom! The application folder and everything in it got replaced, including your project files.

Fortunately, this issue didn’t affect too many people, but when we heard about the problem we decided to immediately pull the Mac distribution of 2021.10.2 while we worked on a fix. The latest 2021.10.3 release goes back to being installer-based, checks for Burp project files within your application folder, and will refuse to update again if any project files are present. In future, we’ll switch back to an archive-based distribution on Macs.

So, with the mystery of the missing Mac release solved, we have a call to action for you. If you use a Mac and are in the habit of saving your project files within the application folder, now is the time to move these elsewhere.