diff --git a/apps/docs/content/docs/platform/self-hosting/integrations-oauth.mdx b/apps/docs/content/docs/platform/self-hosting/integrations-oauth.mdx index a1247719b3a..c57b18f4991 100644 --- a/apps/docs/content/docs/platform/self-hosting/integrations-oauth.mdx +++ b/apps/docs/content/docs/platform/self-hosting/integrations-oauth.mdx @@ -195,7 +195,11 @@ GITHUB_APP_CLIENT_SECRET= GITHUB_APP_PRIVATE_KEY= ``` -The private key must include its PEM header, footer, and contents. Sim accepts actual newlines or escaped `\n` sequences. Keep the private key and client secret in the deployment's server configuration; organization admins select installations in Sim without entering these secrets. +The private key must include its PEM header, footer, and contents. Sim accepts actual newlines or escaped `\n` sequences. When storing it in a JSON secret, use the plaintext JSON editor and encode each line break as `\n` inside the string. Single-line key/value fields can remove line breaks; replacing them with spaces makes the PEM invalid. Restart Sim after saving configuration changes. + +Keep the private key and client secret in the deployment's server configuration; organization admins select installations in Sim without entering these secrets. + +If you run Search indexing on Trigger.dev, configure the same five variables in its matching environment. The app server and indexing worker both need the App credentials; updating the app's secret store alone does not update a separately configured worker. The **Client ID** is different from the numeric **App ID**. Use credentials from **Developer settings → GitHub Apps**. `GITHUB_CLIENT_ID` and `GITHUB_CLIENT_SECRET` belong to the separate GitHub sign-in integration and remain unchanged. Search does not read `GITHUB_REPO_CLIENT_ID` or `GITHUB_REPO_CLIENT_SECRET`. diff --git a/apps/docs/content/docs/search/github.mdx b/apps/docs/content/docs/search/github.mdx index 53a4d329ad9..9a69063e165 100644 --- a/apps/docs/content/docs/search/github.mdx +++ b/apps/docs/content/docs/search/github.mdx @@ -5,6 +5,7 @@ description: Index repository files with a GitHub App while preserving each pers import { Callout } from 'fumadocs-ui/components/callout' import { Step, Steps } from 'fumadocs-ui/components/steps' +import { Image } from '@/components/ui/image' GitHub Search indexes text files from repositories on `github.com`. An organization admin can install the GitHub App once and use it to index selected repositories. Each person connects their own GitHub account once to search the repositories they can access. Installing the App does not connect teammates or give them the installer's permissions. @@ -34,13 +35,20 @@ Open **Settings → Sources** and turn on **GitHub**. Select **Set up** (or **Ma In **Sync documents with**, choose **Connect GitHub App** to index through an installation: +GitHub source setup with indexing choices for connected members, a GitHub account, or a GitHub App + 1. Select **Connect your GitHub account** if prompted. Finish authorization in the new tab, then return and select **Refresh**. + +Connect GitHub App dialog requiring a personal GitHub connection to verify manageable installations + 2. Select **Install GitHub App**. Choose your GitHub account or organization and the repositories to include. If it is already installed, check its repository selection. 3. Return to Sim and select **Refresh**. Choose the installation and select **Use installation**. Only installations on your own account or organizations you own are available. +GitHub App installation chooser with Install GitHub App, Refresh, and Use installation controls; account name redacted + The installation is now selected under **Sync documents with**. You can reuse it when adding another repository source in the same Sim organization. -Alternatively, leave **Connected members** selected to use members' accounts for indexing, or select an existing dedicated account. Each method still requires teammates to connect their own accounts for Search access. +Alternatively, leave **Connected members** selected to use members' accounts for indexing. To use a dedicated indexing account, select it under **Sync documents with**, or choose **Connect GitHub account** to add one. Each method still requires teammates to connect their own accounts for Search access. @@ -51,6 +59,8 @@ Enter **Repository** as `owner/repo`. For installation indexing, it must belong Open **More options** if you need a different branch, path or extension filters, or metadata tags. +GitHub repository configuration with branch, path filter, file extensions, and metadata tags + | Field | What to enter | |---|---| | Repository | `owner/repo`. Add another source for another repository. | diff --git a/apps/docs/public/static/search/github-indexing-options.jpg b/apps/docs/public/static/search/github-indexing-options.jpg new file mode 100644 index 00000000000..ff4a800f808 Binary files /dev/null and b/apps/docs/public/static/search/github-indexing-options.jpg differ diff --git a/apps/docs/public/static/search/github-installation-connect.jpg b/apps/docs/public/static/search/github-installation-connect.jpg new file mode 100644 index 00000000000..dacb637a791 Binary files /dev/null and b/apps/docs/public/static/search/github-installation-connect.jpg differ diff --git a/apps/docs/public/static/search/github-installation-select.jpg b/apps/docs/public/static/search/github-installation-select.jpg new file mode 100644 index 00000000000..a79f975dbff Binary files /dev/null and b/apps/docs/public/static/search/github-installation-select.jpg differ diff --git a/apps/docs/public/static/search/github-setup.jpg b/apps/docs/public/static/search/github-setup.jpg index 3cf512628e9..454bd18b10e 100644 Binary files a/apps/docs/public/static/search/github-setup.jpg and b/apps/docs/public/static/search/github-setup.jpg differ