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!
Disable SIP at your own risk! We are not responsible for any damages, issues, or glitches caused by disabling SIP or by using the Private API.
If you use common sense when downloading and installing things, you should be just fine. Please be careful!
Disabling SIP on an Apple Silicon Mac disables the ability to install and run iOS Apps on your Mac. If this feature is important to you, don't use the Private API.
If you are using a Virtual Machine, please take a snapshot before continuing! You will definitely want a failsafe in case something goes wrong.
Please ensure you have the latest BlueBubbles Server from GitHub Releases!
Now that the warnings are out of the way, lets proceed to the instructions!
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.
Please follow the instructions for your macOS version in the tabs below.
Open Terminal on your macOS device
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
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:
WARNING: This will instantly reboot your Mac. Save everything before executing this command!
sudo nvram recovery-boot-mode=unused
sudo reboot recovery
If you are using a Virtual Machine or a patched macOS software (Open Core), follow this guide.
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
Restart your macOS device/server
Click the Apple logo in the top menu, then click Restart
Turn the Private API switch on in the BlueBubbles Server settings
Verify that the Private API is connected by clicking the refresh button inside the Private API Status box in BlueBubbles Server settings
Go to Settings > Private API Features on the clients you use, and toggle that on. You should now have functioning Private API Features!
Open Terminal on your macOS device
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
Follow the instructions below for your device type
Physical Mac, INTEL, official software
Run the following commands to force your Mac to reboot into recovery mode:
WARNING: This will instantly reboot your Mac. Save everything before executing these commands!
sudo nvram internet-recovery-mode=RecoveryModeDisk
sudo reboot recovery
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
Click the Apple logo in the top menu bar, then click Restart
Physical Mac, APPLE SILICON, official software
Do the following to force your Mac to reboot into recovery mode:
Shut down the Mac normally
Press and hold the power button on your Mac until you see "Loading startup options."
Click Options, then click Continue, and enter the admin password if requested.
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
Click the Apple logo in the top menu bar, then click Restart
macOS on a Virtual Machine or patched macOS software on a Physical Mac
Follow this guide.
Turn the Private API switch on inside the BlueBubbles Server settings
Verify that the Private API is connected by clicking the refresh button inside the Private API Status box in BlueBubbles Server settings
Go to Settings > Private API Features on the clients you use, and toggle that on. You should now have functioning Private API Features!
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!