Available CircleCI self-hosted runner platforms
Cloud Server v3.x Available CircleCI self-hosted runner platforms
CircleCI self-hosted runners are available on multiple platforms. Support levels fall into two categories:
Supported
Supported Level platforms ensure that CircleCI self-hosted runners are both built and tested on their respective systems.
With a Supported platform, users receive the following:
-
Documentation and best practices
-
Support: CircleCI customer engineers will assist customers to resolve issues within their usual Advanced Service Level Agreements (SLAs)
Supported CircleCI self-hosted runners are available on the following platforms:
-
Ubuntu 18.04 or later (x86_64 or ARM64)
-
RHEL8 (x86_64 or ARM64)
-
Mac OS X 10.15+ (Intel)
-
macOS 11.2+ (Apple M1)
-
Docker (x86_64 or ARM64)
-
Kubernetes (x86_64)
-
Windows Server 2019, 2016 (x86_64)
Preview
On Preview Level platforms, CircleCI self-hosted runners are currently in development, thus testing is not complete.
With a Preview platform, users receive the following:
-
A full integration that is a work-in-progress — thus, some manual configuration may be required to install, configure, and deploy
-
Work-in-progress documentation and best practices
-
Support: CircleCI Customer Engineers will provide assistance and guidance on best practices for installing, configuring, and operating CircleCI self-hosted runners
-
Users are encouraged to provide feedback in order to rapidly improve the CircleCI self-hosted runner user experience and meet its necessary criteria as a Supported platform
-
Preview CircleCI self-hosted runners are available on the following platforms:
-
Additional Linux distributions - RHEL, SUSE, Debian, etc. (x86_64 or ARM64)
-
Kubernetes (ARM64)
| Given the active development of Preview CircleCI self-hosted runners, please contact us if you have questions around support for your environment and use-case(s). We also invite you to share feedback and contribute to our runner discuss page to help prioritize development efforts from our team! |
Help make this document better
This guide, as well as the rest of our docs, are open source and available on GitHub. We welcome your contributions.
- Suggest an edit to this page (please read the contributing guide first).
- To report a problem in the documentation, or to submit feedback and comments, please open an issue on GitHub.
- CircleCI is always seeking ways to improve your experience with our platform. If you would like to share feedback, please join our research community.
Need support?
Our support engineers are available to help with service issues, billing, or account related questions, and can help troubleshoot build configurations. Contact our support engineers by opening a ticket.
You can also visit our support site to find support articles, community forums, and training resources.
CircleCI Documentation by CircleCI is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.
