1.0.2 • Public • Published

    NodeBB Discord OAuth2 SSO

    This plugin for NodeBB provides a way to register/authenticate users against Discord. When enabled, and configured properly, there will be a Discord icon available on the login screen. Click that icon to authenticate against Discord.

    New users who register using Discord should have their avatar carry over automatically rather than using the default avatar.


    1. Create an application --
    2. Ensure the application's URI ends with /auth/discord/callback
    3. Create a bot for your application
    4. Fill in the id, secret, and bot token for the application via the NodeBB admin control panel (under "Social Authentication")
    5. Replace your NodeBB FontAwesome fonts with the custom ones included (See below)
    6. Edit your theme's profile.tpl to include a section for Discord information. (See below)

    Using the Discord Logo:

    I have included a modified version of the FontAwesome font that replaces the Discover card (fa-cc-discover) with a simplified Discord logo. I've picked Discover to overwrite because it starts with the same letters, so it's intuitive to search in the NodeBB icon box in case you want to use it elsewhere.

    You'll have to patch this manually by replacing the font files in public/vendor/fontawesome/fonts/ with the ones in the fontawesome-discoverToDiscord folder. I recommend keeping a copy of the folder itself in the font folder so that you can replace everything quickly everytime NodeBB upgrades, since they'll get overwritten with the default FontAwesome fonts.

    If using the Discover card is unacceptable for you, you can do what I did and make your own version of the FontAwesome font using FontForge. Just open up one of the standard FontAweesome fonts included in NodeBB, scroll down to the icon you want to replace (they're buried deep), delete it and import the svg of your choice. Then export all of the filetypes and replace them in the fontawesome folder.

    Profile Information

    A quick panel of the user's full username and their avatar from discord can be added to their profile. Just modify profile.tpl and use

        <!-- IF discordData -->
        <div class="panel panel-default">
            <div class="panel-body text-center">
                <!-- IMPORT partials/account/discord_profile_panel.tpl -->
        <!-- ENDIF discordData -->

    or, if you'd like to inject the data directly, use variables such as {discordData.username}. Currently you can access username, discriminator, id, and pfp (avatar URL), but theoretically any information that can be pulled from Discord.js can be added to DiscordAuth.filterAccount.

    Local Testing URL Override

    I've added a setting in the admin panel that allows a workaround when testing local setups. Localhost isn't a valid OAuth URL, so to bypass this you can use, which will always resolve to Just enter (or whatever your port number is). (Don't forget to add to your application URI in the discord application settings as well!)

    To Do

    • Adjust inconsistencies. SSO sometimes prompts to reauth in profile, and multiple users can auth one account.
    • Remove association button?
    • Clone and upload avatar locally instead of linking to Discord server
    • Add button to Profile Picture editor that allows you to pull your avatar from Discord?


    This plugin is built from the one at


    MIT License


    npm i nodebb-plugin-sso-discord-with-logo

    DownloadsWeekly Downloads






    Unpacked Size

    1.34 MB

    Total Files


    Last publish


    • selkie_lynn