Start Building for Free
CircleCI.comAcademyBlogCommunitySupport

Migrate from launch agent to machine runner 3.0 on Linux - Open preview

3 weeks ago1 min read
Cloud
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