Overview
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
- Register a new OAuth application at https://github.com/settings/developers
- Homepage field:
http://localhost:3000/
- Callback field:
http://localhost:3000/auth/github/callback
- Copy/paste the Client ID and Client Secret into your
.env
file - 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:
- How To Fork And Maintain a Local Instance of Free Code Camp
- How To Create a Pull Request for Free Code Camp
- Open Issues Labeled as Help Wanted
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
Register a new OAuth application at https://github.com/settings/developers and click Register new application
Alternatively, click your Profile Picture => Settings => Applications => Developer applications => Register new application
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
- Application name - choose any name, like
Click Register application to see the newly registered application page with your Client ID and Client Secret
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
Remove / unset with comment block the unwanted provider in passport-provider.
Add SESSION_SECRET and COOKIE_SECRET in
.env
if you get error on express-session and cookieParser.
COOKIE_SECRET='secret'
SESSION_SECRET='secret'
- Run command
node seed
before rungulp
if you dont get the challenges.
Finished
Congratulations! You can now successfully log into your local FCC site using your GitHub account.