Make BitBucket macOS runner auto-start after computer reboot
Asked by Oleksii:

Hello,

I'm already using macOS self hosted runners at mac machine, everything works well until computer reboots, after which I need navigate into runner's bin folder and execute the long script, e.g.:

```
 ./start.sh --accountUuid {13xxxxxxxxx3ae} --repositoryUuid {8fxxxxxxxxx513} --runnerUuid {04xxxxxxxxx1d9} --OAuthClientId yGxxxxxxxxxJxK --OAuthClientSecret ATxxxxxxxxxxA0A --runtime macos-bash --workingDirectory ../temp
```

I'm looking for a way to make runner auto-start after computer reboot, so that it become ONLINE and able to run pipeline which include building react-native app and testing it on the same mac.

I've already tried to set up it using launchd, and the runner was ONLINE and was able to start build process, but I faced with multiple compilation issues, because launchd is starting runner with root user permissions.

I've reviewed these two posts ([Solved: Bitbucket self hosted runner autostart (atlassian.com) and](https://community.atlassian.com/t5/Bitbucket-questions/Bitbucket-self-hosted-runner-autostart/qaq-p/1868071)[Solved: Start and restart Windows self-hosted runner autom... (atlassian.com)](https://community.atlassian.com/t5/Bitbucket-questions/Start-and-restart-Windows-self-hosted-runner-automatically/qaq-p/2158834)), and they didn't give me enough info for my case.

Could you please propose or share any best practices on how to setup runner auto-start at mac after reboot?

Thank you


Answers:
author: Mark C
body: Hi [@raj](/t5/user/viewprofilepage/user-id/5487442)

Welcome to the community.

What you can try to use as well is the app called [Automator](https://support.apple.com/en-au/guide/automator/aut6e8156d85/mac) in macOS.

You can essentially run a script on startup. Here's [an example](https://www.macstadium.com/blog/automating-login-and-startup-events-in-macos) that might help.  

Regards,  
Mark C

comments: author: raj
body: Hi [@Mark C](/t5/user/viewprofilepage/user-id/1210823)

Thanks for your reply and the solution. It did work like a charm.


author: Frank Lichtenheld
body: I used the following plist and it worked fine for me. Note the use of 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>KeepAlive</key>
<true/>
<key>Label</key>
<string>bitbucket-runner</string>
<key>ProgramArguments</key>
<array>
<string>/bin/sh</string>
<string>{{ working_dir }}/start.sh</string>
<string>--accountUuid</string>
<string>{{ BitbucketAccountUuid }}</string>
<string>--runnerUuid</string>
<string>{{ BitbucketRunnerUuid }}</string>
<string>--OAuthClientId</string>
<string>{{ BitbucketOAuthClientId }}</string>
<string>--OAuthClientSecret</string>
<string>{{ BitbucketOAuthClientSecret }}</string>
<string>--runtime</string>
<string>macos-bash</string>
<string>--workingDirectory</string>
<string>../temp</string>
</array>
<key>RunAtLoad</key>
<true/>
<key>UserName</key>
<string>{{ runner_user }}</string>
<key>WorkingDirectory</key>
<string>{{ working_dir }}</string>
<key>EnvironmentVariables</key>
<dict>
<key>PATH</key>
<string>/usr/local/opt/openjdk@11/bin:/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin</string>
</dict>
<key>StandardOutPath</key>
<string>/usr/local/var/log/bitbucket-runner/runner.log</string>
<key>StandardErrorPath</key>
<string>/usr/local/var/log/bitbucket-runner/runner.stderr.log</string>
</dict>
</plist>
```

comments: author: raj
body: Hi [@Frank Lichtenheld](/t5/user/viewprofilepage/user-id/5316578) I really appreciate you for sharing this here as this is the only bit of info I have got regarding BitBucket macOS runner stuff on device boot.

I tried your solution but it didn't work.

I created .plist file with your template and then tried loading the .plist

*launchctl load /path/to/com.example.bbrunner.plist*

I got the following error:  

L*oad failed: 5: Input/output error*

*Try running \`launchctl bootstrap\` as root for richer errors.*

I also tried putting this file in \~/Library/LaunchAgents but still same issue.

Do you think you can guide from here?


Tags: bitbucket-cloud

cloud