docs (#968)

docs/guides/self-hosting/oauth/integrations/github.md

@@ -1 +1,45 @@
-# Github
+---
+sidebar_position: 20
+---
+
+# GitHub OAuth Setup
+
+This guide covers setting up GitHub OAuth for your zrok public frontend.
+
+## Register OAuth Application
+
+Navigate to your GitHub account settings: **Settings > Developer Settings > OAuth Apps > Register a new application**
+
+![](../images/github_create_oauth_application_1.png)
+
+![](../images/github_create_oauth_application_2.png)
+
+Configure the **Authorization callback URL** to match your OAuth frontend address with `/github/oauth` appended:
+
+![](../images/github_create_oauth_application_3.png)
+
+Create a new client secret:
+
+![](../images/github_create_oauth_application_4.png)
+
+Save the client ID and client secret for your frontend configuration.
+
+## Frontend Configuration
+
+Add the GitHub provider to your `frontend.yml`:
+
+```yaml
+oauth:
+  providers:
+    - name: "github"
+      type: "github"
+      client_id: "<your-github-client-id>"
+      client_secret: "<your-github-client-secret>"
+```
+
+## Redirect URL Format
+
+For GitHub OAuth, the redirect URL should be:
+```
+https://your-oauth-frontend-domain:port/github/oauth
+```