Migrate from launch agent to machine runner 3.0 on macOS
This page describes how to migrate an existing launch agent installation to machine runner 3.0. Machine runner 3.0 includes improved network resiliency, and a simpler installation management strategy, utilizing operating system packages.
Migrating from launch agent to machine runner 3.0 is a straightforward process. The prerequisites remain the same. First, uninstall and remove launch agent, then, install the machine runner 3.0 agent. The configuration file is 1:1 compatible between the agents so no modifications are needed during the migration
1. Uninstall launch agent service
The first step is to uninstall launch-agent. If the agent has been installed as a launchctl service run the following commands to stop as well as uninstall the service, and delete the service file.
sudo launchctl unload '/Library/LaunchDaemons/com.circleci.runner.plist'
sudo rm -f '/Library/LaunchDaemons/com.circleci.runner.plist'
sudo rm -rf '/opt/circleci'2. Install the macOS Machine Runner 3.0
Follow the instructions in Install machine runner 3.0 on macOS to install machine runner 3.0 using a Homebrew package.