{"meta":{"title":"Configuring runners for GitHub Copilot cloud agent in your organization","intro":"Configure the GitHub Actions runners used by Copilot cloud agent and control whether repositories can customize the runner type.","product":"GitHub Copilot","breadcrumbs":[{"href":"/en/copilot","title":"GitHub Copilot"},{"href":"/en/copilot/how-tos","title":"How-tos"},{"href":"/en/copilot/how-tos/administer-copilot","title":"Administer Copilot"},{"href":"/en/copilot/how-tos/administer-copilot/manage-for-organization","title":"Manage for organization"},{"href":"/en/copilot/how-tos/administer-copilot/manage-for-organization/configure-runner-for-coding-agent","title":"Configure agent runners"}],"documentType":"article"},"body":"# Configuring runners for GitHub Copilot cloud agent in your organization\n\nConfigure the GitHub Actions runners used by Copilot cloud agent and control whether repositories can customize the runner type.\n\n## About organization-level runner controls\n\nBy default, Copilot cloud agent runs on a standard GitHub-hosted GitHub Actions runner (`ubuntu-latest`). As an organization owner, you can change the default runner type for all repositories in your organization, and choose whether individual repositories are allowed to override this default.\n\nThis is useful if your organization requires all Copilot cloud agent sessions to run on specific runners—for example, to use larger runners for better performance, or to use self-hosted runners that have access to internal resources.\n\nYou can configure:\n\n* **Runner type**: Choose between a standard GitHub-hosted runner or a labeled runner from a specific runner group.\n* **Allow repositories to customize the runner type**: Control whether repositories can override the organization default using a Copilot setup steps workflow defined at `.github/workflows/copilot-setup-steps.yml`.\n\n## Configuring the default runner type\n\n1. In the upper-right corner of GitHub, click your profile picture, then click ** Organizations**.\n2. Select an organization by clicking on it.\n3. Under your organization name, click ** Settings**. If you cannot see the \"Settings\" tab, select the **** dropdown menu, then click **Settings**.\n\n \n4. In the sidebar, under \"Code, planning, and automation\", click ** Copilot**, and then click **Cloud agent**.\n5. Next to \"Runner type,\" click the pencil icon ().\n6. Select the runner type to use by default for Copilot cloud agent across your organization.\n * **Standard GitHub runner**: Copilot cloud agent will use `ubuntu-latest`.\n * **Labeled runner**: Copilot cloud agent will use a runner matching the group name and/or label you specify. Enter values in the **Runner group name** and/or **Runner label** fields.\n7. Click **Save runner selection**.\n\n## Preventing repositories from customizing the runner type\n\nBy default, repositories can override the organization-level runner configuration using a Copilot setup steps workflow located at `.github/workflows/copilot-setup-steps.yml`. If you want to enforce a consistent runner type across all repositories, you can disable this option.\n\n1. In the upper-right corner of GitHub, click your profile picture, then click ** Organizations**.\n2. Select an organization by clicking on it.\n3. Under your organization name, click ** Settings**. If you cannot see the \"Settings\" tab, select the **** dropdown menu, then click **Settings**.\n\n \n4. In the sidebar, under \"Code, planning, and automation\", click ** Copilot**, and then click **Cloud agent**.\n5. Under \"Allow repositories to customize the runner type,\" toggle the setting to enable or disable repository-level customization.\n * When enabled, repositories can override the default runner by setting the `runs-on` field in the `copilot-setup-steps` job of `copilot-setup-steps.yml`. See [Configure the development environment](/en/copilot/how-tos/copilot-on-github/customize-copilot/customize-cloud-agent/customize-the-agent-environment).\n * When disabled, all repositories in your organization will use the organization-level runner type.\n6. Click **Save**.\n\n## Further reading\n\n* [Configure the development environment](/en/copilot/how-tos/copilot-on-github/customize-copilot/customize-cloud-agent/customize-the-agent-environment)\n* [Adding GitHub Copilot cloud agent to your organization](/en/copilot/how-tos/administer-copilot/manage-for-organization/add-copilot-cloud-agent)"}