Configuring Bamboo to start automatically on startup on Mac OS X
Create .plist file
Here is an example of a .plist file that should be located in /Library/LaunchDaemons directory (let's call it com.atlassian.bamboo.plist). Make sure to use the needed username instead of 'USERNAME_RUNNING_BAMBOO' and specify the correct path to the start-bamboo.sh (BAMBOO_INSTALLATION_PATH).
<?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.atlassian.bamboo</string>
<key>UserName</key>
<string>USERNAME_RUNNING_BAMBOO</string>
<key>ProgramArguments</key>
<array>
<string>BAMBOO_INSTALLATION_PATH/start-bamboo.sh</string>
<string>-fg</string>
</array>
<key>SessionCreate</key>
<true/>
<key>RunAtLoad</key>
<true/>
</dict>
</plist>
Install service
After putting com.atlassian.bamboo.plist file in /Library/LaunchDaemons, please run this command:
sudo launchctl load /Library/LaunchDaemons/com.atlassian.bamboo.plistUninstall service
Unload the service:
sudo launchctl unload /Library/LaunchDaemons/com.atlassian.bamboo.plistOptionally the file /Library/LaunchDaemons/com.atlassian.bamboo.plist can be also removed
Extra options
Extra options can be configured as described in Creating Launch Daemons and Agents
Options like:
- Standard error to a file
<key>StandardErrorPath</key>
<string>/var/tmp/bamboo.err</string>Standard out to a file
<key>StandardOutPath</key>
<string>/var/tmp/bamboo.out</string>- Restart the process in case it is stoped
<key>KeepAlive</key>
<true/>
Notes
Service load/unload logs can be found at /var/log/system.log.
The same mechanism can be used to start Bamboo remote agents. Please note that by default macOS daemon doesn't pick up the environment variables from the user, to add it please check the Incorrect environment variables when running remote agent on macOS KB.