Skip to content

Login with Github

In order to setup GitHub login, you firstly need to create a GitHub App

To create a GitHub App, navigate to your User Settings: OwO, first we need to navigate to user settings!

Navigate to Developer Settings: ÓwÓ, now this is something devilish!

Click on OAuth Apps, then on New OAuth App button: ôwô, much wows!

Now, fill in some basic and required settings: finally we made it!

The Authorization callback URL is the most important part. It has to be set to yourforum.freeflarum.com/auth/github. If you are using a Custom Domain, just add the /auth/github to the end of your domain.

Once you have successfuly created your OAuth App, you should be redirected to a page similar to this:

oh no, even more steps!!? c'mon!

The Client ID and Client Secret area is important. You will input those credentials to your GitHub Login extension at your admin dashboard. If you haven't enabled the extension already, go to https://yourforumname.freeflarum.com/admin#/extensions. Find the GitHub Login extension and enable it by clicking on it. yey! GitHub Login located!

Another modal should popup, with Client ID and Client Secret fields. You probably know what to do now - copy your Client Credentials from your App page and paste it into this modal. Hit save.

oh, where are you sneaky modal? OH, THERE YOU ARE!!!

If you have enabled GitHub Login already, you can click on the dotted navigation menu popup to revive the sneaky modal we mentioned above.

we DID IT!!!

If you did all the steps above correctly, congratulations! Your users should be able to login with GitHub now! You can test it in Incognito Mode, if supported.

If an error appeared after logining in using GitHub, please open up a new issue, so we can look into it!