This will walk you through the process of setting up GitHub OAuth for your Zipline instance.

Create a GitHub OAuth Application

  1. Go to the GitHub Developer Settings.
  2. Click the "New OAuth App" button.
  3. Give your application a name.
  4. Make sure the "Authorization callback URL" is https://<your-zipline-domain>/api/auth/oauth/github.
    GitHub OAuth Redirect
    GitHub OAuth Redirect
  5. Click the "Register application" button.
  6. Generate a client secret and save it for later.
    GitHub Generate Secret
    GitHub Generate Secret
  7. Copy the "Client ID" and save it for later.

Configure Zipline

Set the OAUTH_GITHUB_CLIENT_ID and OAUTH_GITHUB_CLIENT_SECRET environment variables to the values you copied earlier.


Make sure you have the FEATURES_OAUTH_REGISTRATION environment variable set to true, or none of the endpoints will work.

If you have set up everything correctly, you can now navigate to the login page and click the "Login with GitHub" button.

Last updated: 8/4/2023
Edit this page on GitHub