301-Moved Permanently on Self Hosted runner

Problem

Users may encounter an error message in the Runners log stating: unexpected error claiming task: server supplied detail: https://runner.circleci.com/api/v3/runner/claim (301-Moved Permanently). This issue is generally urgent and requires immediate attention.

Solution

To resolve this issue and ensure continued seamless operation, it is recommended to migrate from the launch agent to Machine Runner 3.0.

Here are the appropriate migration guides based on your operating system:

• Migrate from Launch Agent to Machine Runner 3.0 on Linux
• Migrate from Launch Agent to Machine Runner 3.0 on macOS
• Migrate from Launch Agent to Machine Runner 3.0 on Windows

Please follow the respective guide carefully to ensure a smooth transition.

Conclusion

CircleCI strives to provide a seamless experience for all users. If you encounter any issues during the migration process or have further questions, feel free to reach out to the CircleCI support team.

Additional Resources

• ​Launch Agent 1.x Variants End of Life
• Machine Runner 3.0 GA with Support for macOS and Windows
• "could not update launch-agent to new version" Error on Runner