Installation

How to configure your server to enable the Private API

In order to get Private API features, you must disable MacOS extra security measures, called System Integrity Protection (SIP). The reason for this is because Apple does not let us access the internal iMessage code to do things like send reactions if SIP is enabled. When disabled, we can inject a helper process into the iMessage app to call the internal functions for us. In a way, disabling SIP is similar to Jailbreaking your iPhone.

Disabling SIP can be challenging, we recommend joining our Discord to get assistance with the process if you need it!

Now that the warnings are out of the way, lets proceed to the instructions!

Supported Device Info

The Helper Bundle currently supports macOS 10.13 and up, on both Intel and Apple Silicon Macs.

It may support lower macOS versions, but we haven't been able to test them yet.

Instructions

Please follow the instructions for your macOS version in the tabs below.

  1. Open Terminal on your macOS device

  2. Run the following command to disable Library Validation and enter your password when prompted.

    sudo defaults write /Library/Preferences/com.apple.security.libraryvalidation.plist DisableLibraryValidation -bool true

  3. Run the following commands to force your Mac to reboot into recovery mode:

    • WARNING: DO NOT do this step or step 4-5 if you are running dos1dude's patched High Sierra/Mojave/Catalina. It may temporarily brick your Mac until you reset your NVRAM/PRAM

    • If you are on a real Mac with official macOS, do the following:

      1. WARNING: This will instantly reboot your Mac. Save everything before executing this command!

      2. sudo nvram recovery-boot-mode=unused

      3. sudo reboot recovery

    • If you are using a Virtual Machine or a patched macOS software (Open Core), follow this guide.

  4. When you are booted into Recovery Mode:

    • Click on Utilities in the top menu bar

    • Select Terminal

    • Type this command and hit enter to disable SIP: csrutil disable

  5. Restart your macOS device/server

    • Click the Apple logo in the top menu, then click Restart

  6. Turn the Private API switch on in the BlueBubbles Server settings

  7. Verify that the Private API is connected by clicking the refresh button inside the Private API Status box in BlueBubbles Server settings

  8. Go to Settings > Private API Features on the clients you use, and toggle that on. You should now have functioning Private API Features!

Troubleshooting

Here are some basic troubleshooting steps. Please try these out, and if you need more help, feel free to join our Discord!

  • Make sure you have the Private API switch turned on in both the server and the client app

  • Try force quitting and reopening the server (with private API switch toggled on)

  • Run csrutil status inside Terminal, then join our Discord and let us know what the output is.

If none of this works, you should join our Discord and the developers will be able to help you out. In your post, please include your macOS version, Mac chipset (Intel / Apple Silicon), and your server version. Thanks!

Last updated

Was this helpful?