Autostart Server After Crash
This document will guide you on how you can configure your Mac to automatically restart the BlueBubbles Server app if the app crashes (unsafe exit)
Open the TextEdit app on your Mac
Copy & paste the following XML into the new text file: Note: Modify the "Program" string value to the location of your BlueBubbles.app, and/or replace
{username}
with your macOS username<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd"> <plist version="1.0"> <dict> <key>Label</key> <string>com.bluebubbles.server</string> <key>Program</key> <string>/Users/{username}/Applications/BlueBubbles.app/Contents/MacOS/BlueBubbles</string> <key>RunAtLoad</key> <true/> <key>KeepAlive</key> <dict> <key>SuccessfulExit</key> <false/> </dict> </dict> </plist>
This will make sure that the specified program will be run when you first login to your Mac (
RunAtLoad
), and will be restarted if it crashes (KeepAlive
). TheSuccessfulExit: false
flag means that the app will not be restarted if the server exits successfully; for example, if you manually close the app.Save the file to
~/Library/LaunchAgents/com.bluebubbles.server.plist
CMD + S
to save the fileCMD + Shift + G
to open a file locationPaste
~/Library/
into the popup and hit EnterFind the
LaunchAgents
folder and open itIf it does not exist, create it using the
New Folder
button
Enter
com.bluebubbles.server.plist
in theSave As
field
Disable the built-in autostart option in the BlueBubbles Server:
Install the launch agent and load it after the current user graphically logs in:
launchctl bootstrap gui/$(id -u $(whoami)) ~/Library/LaunchAgents/com.bluebubbles.server.plist
Immediately start the launch agent (only necessary for the first time):
launchctl kickstart gui/$(id -u $(whoami))/com.bluebubbles.server
Some additional notes:
To uninstall the launch agent:
launchctl remove com.bluebubbles.server
To print information about the launch agent:
launchctl print gui/$(id -u $(whoami))/com.bluebubbles.server
Last updated
Was this helpful?