How to Log in To your local instance of Free Code Camp

Guide
1

This guide will help you log in to your local FCC site using your GitHub account. This process should be similar for logging in with other social media accounts. This guide assumes you already have a local copy of FCC up and running.

TL;DR

  1. Register a new OAuth application
  2. Homepage field: http://localhost:3000/
  3. Callback field: http://localhost:3000/auth/github/callback
  4. Copy/paste the Client ID and Client Secret into your .env file
  5. Use port 3000 when viewing your local FCC site

Free Code Camp Issue Mods and staff are on hand to assist with Pull Request related issues on our Help Contributors Chat Room

Disclaimer

Make sure to log in on port 3000, port 3001 will not work.

Log In Using Your GitHub Account

  1. Register a new OAuth application and click Register new application

Alternatively, click your Profile Picture => Settings => Applications => Developer applications => Register new application

Register GitHub OAuth App


  1. Fill out OAuth application fields
  • Application name - choose any name, like fcc-local
  • Homepage URL - set to http://localhost:3000/
  • Application description - optional
  • Authorization callback URL - set to http://localhost:3000/auth/github/callback
  1. Click Register application to see the newly registered application page with your Client ID and Client Secret.

Client ID and Client Secret

  1. Copy and paste your Client ID and Client Secret into your .env file.

Note: your Client ID and Client Secret will be long alphanumeric values.

Tips

  1. Remove / unset with comment block the unwanted provider in passport-provider.

  2. Add SESSION_SECRET and COOKIE_SECRET in .env if you get error on express-session and cookieParser.

COOKIE_SECRET='secret'
SESSION_SECRET='secret'
  1. Run command node seed before run gulp if you dont get the challenges.

Finished

Congratulations! You can now successfully log into your local FCC site using your GitHub account.