You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
A self-hosted runner is a system that you deploy and manage to execute jobs from {% data variables.product.prodname_actions %} on {% data variables.product.github %}.
19
18
20
19
Self-hosted runners:
21
20
22
21
{% ifversion fpt or ghec %}
23
-
* Give you more control of hardware, operating system, and software tools than {% data variables.product.prodname_dotcom %}-hosted runners provide.{% endif %}
22
+
* Give you more control of hardware, operating system, and software tools than {% data variables.product.prodname_dotcom %}-hosted runners provide. Be aware that you are responsible for updating the operating system and all other software.{% endif %}
24
23
* Are free to use with {% data variables.product.prodname_actions %}, but you are responsible for the cost of maintaining your runner machines.
25
24
* Let you create custom hardware configurations that meet your needs with processing power or memory to run larger jobs, install software available on your local network.
26
25
* Receive automatic updates for the self-hosted runner application only, though you may disable automatic updates of the runner.
@@ -31,30 +30,12 @@ Self-hosted runners:
31
30
32
31
You can use self-hosted runners anywhere in the management hierarchy. Repository-level runners are dedicated to a single repository, while organization-level runners can process jobs for multiple repositories in an organization. Organization owners can choose which repositories are allowed to create repository-level self-hosted runners. See [AUTOTITLE](/organizations/managing-organization-settings/disabling-or-limiting-github-actions-for-your-organization#limiting-the-use-of-self-hosted-runners). Finally, enterprise-level runners can be assigned to multiple organizations in an enterprise account.
33
32
34
-
### Requirements for self-hosted runner machines
35
-
36
-
You can use any machine as a self-hosted runner as long as it meets these requirements:
37
-
38
-
* You can install and run the self-hosted runner application on the machine.
39
-
* The machine can communicate with {% data variables.product.prodname_actions %}.
40
-
* The machine has enough hardware resources for the type of workflows you plan to run. The self-hosted runner application itself only requires minimal resources.
41
-
* If you want to run workflows that use Docker container actions or service containers, you must use a Linux machine and Docker must be installed.
42
-
43
-
{% ifversion ghes %}
44
-
45
-
## Supported actions on self-hosted runners
46
-
47
-
All `actions/setup-LANGUAGE` action repositories currently support three platforms: macOS, Windows, and Ubuntu.
48
-
Some extra configuration might be required to use actions from {% data variables.product.github %} with {% data variables.product.prodname_ghe_server %}, or to use the `actions/setup-LANGUAGE` actions with self-hosted runners that do not have internet access. For more information, see [AUTOTITLE](/admin/github-actions/managing-access-to-actions-from-githubcom) and contact your {% data variables.product.prodname_enterprise %} site administrator.
33
+
## Next steps
49
34
35
+
{% ifversion ghec or ghes %}
36
+
To get hands-on experience with the policies and usage of self-hosted runners, see [AUTOTITLE](/admin/github-actions/getting-started-with-github-actions-for-your-enterprise/getting-started-with-self-hosted-runners-for-your-enterprise)
37
+
{% else %}
38
+
To set up a self-hosted runner in your workspace, see [AUTOTITLE](/actions/how-tos/hosting-your-own-runners/managing-self-hosted-runners/adding-self-hosted-runners).
To find information about the requirements and supported software and hardware for self-hosted runners, see [AUTOTITLE](/actions/reference/self-hosted-runners-reference).
You can use a machine as a self-hosted runner as long as it meets these requirements:
18
+
19
+
* You can install and run the self-hosted runner application on the machine. See [Supported operating systems](#supported-operating-systems) and [Supported processor architectures](#supported-processor-architectures).
20
+
* The machine can communicate with {% data variables.product.prodname_actions %}.
21
+
* The machine has enough hardware resources for the type of workflows you plan to run. The self-hosted runner application itself only requires minimal resources.
22
+
* If you want to run workflows that use Docker container actions or service containers, you must use a Linux machine and Docker must be installed.
23
+
24
+
### Supported operating systems
25
+
26
+
#### Linux
27
+
28
+
* Red Hat Enterprise Linux 8 or later
29
+
* CentOS 8 or later
30
+
* Oracle Linux 8 or later
31
+
* Fedora 29 or later
32
+
* Debian 10 or later
33
+
* Ubuntu 20.04 or later
34
+
* Linux Mint 20 or later
35
+
* openSUSE 15.2 or later
36
+
* SUSE Enterprise Linux (SLES) 15 SP2 or later
37
+
38
+
#### Windows
39
+
40
+
* Windows 10 64-bit
41
+
* Windows 11 64-bit
42
+
* Windows Server 2016 64-bit
43
+
* Windows Server 2019 64-bit
44
+
* Windows Server 2022 64-bit
45
+
46
+
#### macOS
47
+
48
+
* macOS 11.0 (Big Sur) or later
49
+
50
+
### Supported processor architectures
51
+
52
+
*`x64` - Linux, macOS, Windows.
53
+
*`ARM64` - Linux, macOS{% ifversion actions-windows-arm %}, Windows (currently in {% data variables.release-phases.public_preview %}){% endif %}.
0 commit comments