Skip to content

Clarify limitations linked to standalone orgs VS GitHub App pipelines #9660

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
Oct 7, 2025
Merged

Clarify limitations linked to standalone orgs VS GitHub App pipelines #9660

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
2357fdb
Update github-apps-integration.adoc
BeFunes Oct 7, 2025
2c592c9
Update github-apps-integration.adoc
BeFunes Oct 7, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 6 additions & 6 deletions docs/guides/modules/integration/pages/github-apps-integration.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -172,16 +172,16 @@ The following sections are features of CircleCI which are not yet supported when

[#restrict-a-context-to-a-security-group]
=== Restrict a context to a security group
The ability to xref:security:contexts.adoc#security-group-restrictions[restrict a context to a security group] is not yet supported for GitHub App projects.
The ability to xref:security:contexts.adoc#security-group-restrictions[restrict a context to a security group] is supported for GitHub App pipelines only for organizations that have `/github/` (or `/gh/`) in the URL, no matter the pipeline integration type. It is not yet supported for organizations that have `/circleci/` in the URL. You can follow development progress link:https://circleci.canny.io/cloud-feature-requests/p/ability-to-use-security-groups-for-contexts-used-by-github-app-type-pipelines[here].

[#in-app-config-editor]
=== In-app config editor
The in-app config editor is currently **only** available for GitHub App accounts during project creation.
The in-app config editor is not currently available for GitHub App pipelines, except during project creation.

[#account-integrations]
=== Account integrations

Viewing menu:User settings[Account integrations] does not currently show a GitHub App integration. This page only shows GitHub OAuth app integrations.
The page menu:User settings[Account integrations] does not currently list the GitHub App integration, even though your account may be correctly connected. This page only shows GitHub OAuth app integrations.

[#build-forked-pull-requests]
=== Build forked pull requests
Expand All @@ -196,12 +196,12 @@ Passing secrets to forked pull requests is not currently supported for GitHub Ap
[#stop-building]
=== Stop building

GitHub App integrations do not currently support the **Stop Building** option that can normally be found in **Project settings**. However, the same functionality can be achieved by deleting (or disabling) all triggers associated with existing pipelines, from menu:Project Settings[Project setup].
Projecs in organizations with `/circleci/` in the URL do not have the **Stop Building** option that can normally be found in **Project settings**. However, the same functionality can be achieved by deleting (or disabling) all triggers associated with existing pipelines, from menu:Project Settings[Project setup].

[#additional-ssh-keys-only]
=== Additional SSH keys only

Deploy keys and user keys are not used by GitHub App integrations. All keys are stored in menu:Project Settings[ Additional SSH Keys]. If you are looking to set up an SSH key to check out code from additional repositories in GitHub, see xref:add-ssh-key.adoc#steps-to-add-additional-ssh-keys[Add additional SSH keys].
Deploy keys and user keys are not used in projects with `/circleci/` in the URL. Instead, all keys are stored in menu:Project Settings[ Additional SSH Keys]. If you are looking to set up an SSH key to check out code from additional repositories in GitHub, see xref:add-ssh-key.adoc#steps-to-add-additional-ssh-keys[Add additional SSH keys].

[#outbound-webhooks]
=== Outbound webhooks
Expand All @@ -210,7 +210,7 @@ While outbound webhooks *are* available for GitHub App pipelines, their payload
[#test-insights]
=== Test Insights

xref:insights:insights-tests.adoc[Test Insights] is currently not supported for orgs authenticated with the CircleCI GitHub App. Test Insights is available for GitHub OAuth authenticated orgs that have GitHub App pipelines set up.
xref:insights:insights-tests.adoc[Test Insights] is currently not supported for orgs with `/circleci/` in the URL. Test Insights is available for GitHub OAuth authenticated orgs that have GitHub App pipelines set up.

[#next-steps]
== Next steps
Expand Down