SOLFIND
Web Lens
Portal home

GitHub OAuth | Appsmith

https://docs.appsmith.com/getting-started/setup/instance-configuration/authentication/github-login • 50 KB fetched
Open original page


GitHub OAuth | Appsmith

Skip to main content

Ask AI
Search

Ask Appsmith AI Submit message

Examples How do I install Appsmith using Docker? How do I connect to my local PostgreSQL database? How do I pass inputs from a widget to a query? How do I trigger multiple queries conditionally? How do I fix the error: This value does not evaluate to type Array<Object>?

Search

Try Appsmith

* Get Started

* Introduction

* Build Your First App

* Self Hosting

* New Installation Guides

* Manage Installation

* High Availability Guides

* Authentication Guides

* Google OAuth

* GitHub OAuth

* SAML SSO

* OpenID Connect SSO

* Helm Chart

* Custom Domain and SSL Guides

* Email Setup Guides

* Backup and Restore Guides

* Other Configuration Guides

* Reference

* Upgrade Installation Guides

* Concepts

* Connect Data

* Overview

* How-to Guides

* Reference

* Datasources

* Query Settings

* Concepts

* Build Apps

* Overview

* Quickstart

* How-to Guides

* Reference

* Widgets

* Accessibility

* Theme

* Sample Apps

* Write Code

* Overview

* How-to Guides

* Reference

* Global Objects

* Global Functions

* JS Libraries

* Fetch API

* Data Transformation

* JavaScript Settings

* Concepts

* Best Practices

* Manage Apps and Users

* Authentication

* Granular Access Control

* Versioning with Git

* Setup SCIM Provisioning

* Embed Appsmith

* Migrate Applications

* Audit Logs

* Branding

* External Client Portal

* Packages

* Overview

* Tutorial

* How-to Guides

* Reference

* Package Version Control

* GIT Apps with Packages Best Practices

* Code Packages

* UI Packages

* Workflows

* Overview

* Tutorial

* How-to Guides

* Reference

* Workflow Triggers

* Workflow Queries

* Workflow Functions

* Pass Parameters to Workflows

* Run History

* Troubleshooting

* Overview

* Self-hosting Errors

* Application Errors

* Product

* FAQ

* Security

* Telemetry

* Support at Appsmith

* Privacy Policy

* Release Notes

* Contribute

© 2026 Appsmith, Inc.

*

* Self Hosting

* Manage Installation

* Authentication Guides

* GitHub OAuth
On this page
GitHub OAuth

This page shows how to configure Appsmith to use GitHub OAuth as an authentication provider. By integrating with GitHub OAuth, Appsmith enables end users to sign in to their Appsmith accounts using their GitHub credentials.

Prerequisites ​

* A self-hosted Appsmith instance. See the installation guides for installing Appsmith.

* A GitHub account.

* Before setting up GitHub OAuth, ensure that you have already configured a custom domain for your instance.

* In Appsmith, go to Admin Settings > Authentication and click Enable on GitHub .

Create OAuth App on GitHub ​

*
Open your GitHub Account .

*
Navigate to your profile icon in the top-right corner and open Settings .

*
In Settings , go to Developer Settings > OAuth Apps and click New OAuth apps to configure a new Appsmith OAuth app.

* Add the following details for the OAuth app configuration:

*
Application Name: Enter a name for your application (e.g., Appsmith GitHub OAuth ).

*
Homepage URL: Copy and paste the Homepage URL from the GitHub configuration in Appsmith (e.g., https://app.appsmith.com ).

*
Authorization Callback URL: Copy and paste the Callback URL from the GitHub configuration in Appsmith (e.g., https://app.appsmith.com/login/oauth2/code/github ) and paste it here.

* Click Register application to create the OAuth app. Once the app is created, copy the Client ID and Client Secret to use in Appsmith’s GitHub configuration.

Register GitHub OAuth in Appsmith ​

To complete the Github OAuth configuration, you have to register the provider on Appsmith. Go to Admin Settings > Authentication > Github , and follow the steps below:

*
Add the Client ID and Client Secret copied from the Github OAuth Settings into the respective fields.

*
Once you have added the details, click the Save & Restart button to save the configuration and restart the instance.

info
If you're running Appsmith on a Kubernetes cluster with an HA configuration, after completing the setup, run the following command to ensure the new authentication settings are properly applied:
kubectl rollout restart deployment / appsmith - n

After the Appsmith instance restarts, log in to your account to see the GitHub Login button on the login screen.

See also ​

* Manage Installation : Learn how to manage your Appsmith instance.

* Upgrade Installation Guides : Learn how to upgrade your Appsmith installation.

Was this page helpful?

Edit this page

Previous
Google OAuth
Next
SAML SSO

* Prerequisites

* Create OAuth App on GitHub

* Register GitHub OAuth in Appsmith

* See also

Links found on this page

  1. Skip to main content [direct]
  2. Try Appsmith [direct]
  3. Get Started [direct]
  4. Build Your First App [direct]
  5. Self Hosting [direct]
  6. New Installation Guides [direct]
  7. Manage Installation [direct]
  8. High Availability Guides [direct]
  9. Authentication Guides [direct]
  10. Google OAuth [direct]
  11. SAML SSO [direct]
  12. OpenID Connect SSO [direct]
  13. Helm Chart [direct]
  14. Custom Domain and SSL Guides [direct]
  15. Email Setup Guides [direct]
  16. Backup and Restore Guides [direct]
  17. Other Configuration Guides [direct]
  18. Reference [direct]
  19. Upgrade Installation Guides [direct]
  20. Concepts [direct]
  21. Connect Data [direct]
  22. How-to Guides [direct]
  23. Reference [direct]
  24. Query Settings [direct]
  25. Concepts [direct]
  26. Build Apps [direct]
  27. Quickstart [direct]
  28. How-to Guides [direct]
  29. Reference [direct]
  30. Widgets [direct]
  31. Accessibility [direct]
  32. Theme [direct]
  33. Sample Apps [direct]
  34. Write Code [direct]
  35. How-to Guides [direct]
  36. Reference [direct]
  37. Global Objects [direct]
  38. Global Functions [direct]
  39. JS Libraries [direct]
  40. Fetch API [direct]
  41. Data Transformation [direct]
  42. JavaScript Settings [direct]
  43. Concepts [direct]
  44. Best Practices [direct]
  45. Granular Access Control [direct]
  46. Versioning with Git [direct]
  47. Setup SCIM Provisioning [direct]
  48. Embed Appsmith [direct]
  49. Migrate Applications [direct]
  50. Audit Logs [direct]
  51. Branding [direct]
  52. External Client Portal [direct]
  53. Packages [direct]
  54. Tutorial [direct]
  55. How-to Guides [direct]
  56. Reference [direct]
  57. GIT Apps with Packages Best Practices [direct]
  58. Code Packages [direct]
  59. UI Packages [direct]
  60. Workflows [direct]
  61. Tutorial [direct]
  62. How-to Guides [direct]
  63. Reference [direct]
  64. Workflow Queries [direct]
  65. Workflow Functions [direct]
  66. Pass Parameters to Workflows [direct]
  67. Run History [direct]
  68. Troubleshooting [direct]
  69. Self-hosting Errors [direct]
  70. Application Errors [direct]
  71. Product [direct]
  72. Security [direct]
  73. Telemetry [direct]
  74. Support at Appsmith [direct]
  75. Privacy Policy [direct]
  76. Release Notes [direct]
  77. Contribute [direct]
  78. GitHub OAuth [direct]
  79. GitHub [direct]
  80. GitHub Account [direct]