Start Building for Free

Migrate from launch agent to machine runner 3.0 on macOS

2 months ago1 min read
Server v4.4+
On This Page

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.

Suggest an edit to this page

Make a contribution
Learn how to contribute