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

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

Need Help?

If you need help getting FCC setup on your local machine, here are a few useful links to help you get started:

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

Disclaimer

The output from running $ gulp mentions the Access Port is 3001. I have only successfully logged in with GitHub at port 3000 - the Proxy Port. If you understand how to log in using other ports, please consider submitting a pull request on this wiki.

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.

Update .env file

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.