You need to be signed into your Ferndesk workspace before connecting an integration. Make sure you're logged in and that you're in the correct organization. If you have access to multiple Ferndesk workspaces, switch to the one where you want to add the GitHub connection.
GitHub integration
Connect your GitHub account to Ferndesk. This integration allows Fern to browse your codebase and understand how features work, which helps generate more accurate and relevant help center articles.
Watch this video to learn how the GitHub integration works:
You'll need a GitHub account to complete this integration. If you don't have one, create one on the GitHub website.
Connect GitHub
1
Go to Integrations
From your Ferndesk dashboard, click Integrations in the sidebar.
Make sure you're signed into the correct Ferndesk workspace. The integration will connect to the organization you're currently viewing.
2
Click Connect
Find GitHub in the integrations list and click Connect.
3
Authorize in GitHub
You'll be redirected to GitHub to authorize the connection. Log in to your GitHub account if you're not already logged in.
Grant Ferndesk permission to access your GitHub account. You can select which repositories to connect—you can choose multiple repositories if your project spans multiple repos, such as a backend and dashboard in separate repositories.
4
Return to Ferndesk
After authorizing, you'll be redirected back to Ferndesk. The GitHub integration will show as connected, and Fern will be able to browse your codebase.
Once connected, Fern can browse your codebase to provide more accurate and relevant help center articles.
Manage connected repositories
After your initial setup, you can add or remove repositories by visiting your GitHub app settings. Go to your GitHub account settings, navigate to Applications, and find Ferndesk in your installed integrations to adjust repository access.
Troubleshooting
I see "Authentication required to connect GitHub"
I see "GitHub OAuth organization does not match the active session"
The GitHub account or organization you're authorizing belongs to a different organization than the one you're signed into in Ferndesk. Make sure you're:
Signed into the correct Ferndesk workspace
Authorizing the GitHub account or organization that corresponds to that Ferndesk organization
If you need to connect a different GitHub organization to a different Ferndesk workspace, switch to that workspace in Ferndesk first, then connect GitHub.
The GitHub authorization page shows an error
This can happen if:
Your session expired—try signing out of Ferndesk and signing back in
The OAuth state became invalid—close the authorization window and click Connect again in Ferndesk
Additional resources
For more information on GitHub's features, visit their Documentation.
Was this helpful?