diff --git a/public/docs/i/1000/platform-hub/platform-hub-github-connections.webp b/public/docs/i/1000/platform-hub/platform-hub-github-connections.webp new file mode 100644 index 0000000000..329fd63c4a Binary files /dev/null and b/public/docs/i/1000/platform-hub/platform-hub-github-connections.webp differ diff --git a/public/docs/i/1000/platform-hub/platform-hub-version-control-github-connection.webp b/public/docs/i/1000/platform-hub/platform-hub-version-control-github-connection.webp new file mode 100644 index 0000000000..910009a841 Binary files /dev/null and b/public/docs/i/1000/platform-hub/platform-hub-version-control-github-connection.webp differ diff --git a/public/docs/i/2000/platform-hub/platform-hub-github-connections.webp b/public/docs/i/2000/platform-hub/platform-hub-github-connections.webp new file mode 100644 index 0000000000..5680b8dd5c Binary files /dev/null and b/public/docs/i/2000/platform-hub/platform-hub-github-connections.webp differ diff --git a/public/docs/i/2000/platform-hub/platform-hub-version-control-github-connection.webp b/public/docs/i/2000/platform-hub/platform-hub-version-control-github-connection.webp new file mode 100644 index 0000000000..67da44c5c8 Binary files /dev/null and b/public/docs/i/2000/platform-hub/platform-hub-version-control-github-connection.webp differ diff --git a/public/docs/i/600/platform-hub/platform-hub-github-connections.webp b/public/docs/i/600/platform-hub/platform-hub-github-connections.webp new file mode 100644 index 0000000000..c3774c6e87 Binary files /dev/null and b/public/docs/i/600/platform-hub/platform-hub-github-connections.webp differ diff --git a/public/docs/i/600/platform-hub/platform-hub-version-control-github-connection.webp b/public/docs/i/600/platform-hub/platform-hub-version-control-github-connection.webp new file mode 100644 index 0000000000..e1fd2514be Binary files /dev/null and b/public/docs/i/600/platform-hub/platform-hub-version-control-github-connection.webp differ diff --git a/public/docs/i/x/platform-hub/platform-hub-github-connections.png b/public/docs/i/x/platform-hub/platform-hub-github-connections.png new file mode 100644 index 0000000000..569eef48c6 Binary files /dev/null and b/public/docs/i/x/platform-hub/platform-hub-github-connections.png differ diff --git a/public/docs/i/x/platform-hub/platform-hub-version-control-github-connection.png b/public/docs/i/x/platform-hub/platform-hub-version-control-github-connection.png new file mode 100644 index 0000000000..c4af1f2bc6 Binary files /dev/null and b/public/docs/i/x/platform-hub/platform-hub-version-control-github-connection.png differ diff --git a/public/docs/img/platform-hub/platform-hub-github-connections.png b/public/docs/img/platform-hub/platform-hub-github-connections.png new file mode 100644 index 0000000000..cff59e3fda Binary files /dev/null and b/public/docs/img/platform-hub/platform-hub-github-connections.png differ diff --git a/public/docs/img/platform-hub/platform-hub-github-connections.png.json b/public/docs/img/platform-hub/platform-hub-github-connections.png.json new file mode 100644 index 0000000000..061fbaa103 --- /dev/null +++ b/public/docs/img/platform-hub/platform-hub-github-connections.png.json @@ -0,0 +1 @@ +{"width":1637,"height":719,"updated":"2026-05-01T00:35:49.394Z"} \ No newline at end of file diff --git a/public/docs/img/platform-hub/platform-hub-version-control-github-connection.png b/public/docs/img/platform-hub/platform-hub-version-control-github-connection.png new file mode 100644 index 0000000000..dea3533060 Binary files /dev/null and b/public/docs/img/platform-hub/platform-hub-version-control-github-connection.png differ diff --git a/public/docs/img/platform-hub/platform-hub-version-control-github-connection.png.json b/public/docs/img/platform-hub/platform-hub-version-control-github-connection.png.json new file mode 100644 index 0000000000..aebb4dcb40 --- /dev/null +++ b/public/docs/img/platform-hub/platform-hub-version-control-github-connection.png.json @@ -0,0 +1 @@ +{"width":1650,"height":734,"updated":"2026-05-01T00:35:49.421Z"} \ No newline at end of file diff --git a/src/pages/docs/platform-hub/index.md b/src/pages/docs/platform-hub/index.md index f221822ae1..daf0104feb 100644 --- a/src/pages/docs/platform-hub/index.md +++ b/src/pages/docs/platform-hub/index.md @@ -59,3 +59,32 @@ You can create and manage Git credentials in Platform Hub by visiting the Git cr :::figure ![Platform Hub Git credentials area](/docs/img/platform-hub/platform-hub-git-credential.png) ::: + +## GitHub App Connections in Platform Hub + +You can connect your GitHub accounts to Platform Hub using the Octopus GitHub App. This lets you use a GitHub App Connection when configuring Platform Hub's version control settings, without needing a personal access token. + +:::div{.hint} +GitHub App Connections in Platform Hub can only be used to configure Platform Hub's version control settings. These GitHub Connections are scoped only to Platform Hub, and cannot be used in spaces. They also cannot be used in steps in process templates or project templates currently. +::: + +### Set up a GitHub App Connection + +To configure a GitHub App Connection in Platform Hub, navigate to **GitHub Connections** and follow the same steps as [connecting a GitHub account in a space](/docs/projects/version-control/github#connecting-a-github-account). + +:::figure +![GitHub Connections page in Platform Hub](/docs/img/platform-hub/platform-hub-github-connections.png) +::: + +### Use a GitHub App Connection for version control + +Once you've configured a connection, you can select it when setting up Platform Hub's version control. + +1. Navigate to **Version Control** in Platform Hub. +2. Select "GitHub". +3. Under GitHub Repository, choose your GitHub Connection and the repository where your Platform Hub configurations will be stored. +4. Save your settings. + +:::figure +![Version control configuration in Platform Hub using a GitHub App Connection](/docs/img/platform-hub/platform-hub-version-control-github-connection.png) +:::