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.plist
Uninstall service
Unload the service:
sudo launchctl unload /Library/LaunchDaemons/com.atlassian.bamboo.plist
Optionally 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/>
注意
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.