The web based version of the Relational Database curriculum is here! Follow the steps below to run the courses in your browser. If you want to run them locally instead, you can learn how here. Note: you cannot earn your certification running these locally.
How to get started
Follow these steps to get started with the browser version of the courses:
- First, you will need to create a GitHub account if don’t have one
If you don’t want to save your progress, you can skip to step 4 after you have a GitHub account
Note: You cannot earn your certification without saving your progress - After that, go to http://freecodecamp.org/learn/relational-database/
- To save your progress on freeCodeCamp.org, you will need to be signed in. Click the sign in button at the top right and sign in if you aren’t already
- Go to http://freecodecamp.org/learn/relational-database/
- Click on one of the courses to go to the course page
- Find and click the button to “start the course”
- Click “Run With CodeAlly” when the button appears
- You will need to sign in to CodeAlly using your GitHub account. This will redirect you away from the page. After you’re signed in there, repeat steps 4-7. You will only need to do this once. Running subsequent courses will not redirect you away from the page.
Note: You must have third party cookies enabled to log in to CodeAlly to run the course.
From there, it may take a few moments, but the tutorial should start automatically. It will load a virtual machine with VS Code running and launch the CodeRoad extension, which will start the tutorial. Follow the instructions in CodeRoad to go through it. If you get stuck at any point, see the troubleshooting steps below.
Troubleshooting
If you’re stuck in some way, continue reading to learn how to troubleshoot some of the issues we’ve seen…
Issues with starting a course:
Nothing happened when I clicked start
If you see a blank white screen with only the freeCodeCamp navbar or you are stuck in a loop of trying to login to CodeAlly, you likely need to enable third-party cookies. Enable them and try again. Some browser extensions can block cookies as well, so you may need to disable the extension or adjust settings in there.
You are stuck on the last step of ‘Loading remote environment’
It shouldn’t take more than a minute or so to go through the steps above. If it seems stuck on the last step, refresh the page and start the project again. It should then finish the loading process.
Your container loaded, but CodeRoad didn’t start automatically
If CodeRoad didn’t load automatically, open the command palette and start the extension manually:
CodeRoad started, but it’s blank and didn’t load the course
If CodeRoad loaded but your course didn’t start, close the CodeRoad tab and manually reopen it, as shown above. Repeat until it loads your course.
Your container loaded, but the terminal is not visible
To open the terminal, click on the hamburger menu on the upper left corner > Terminal > New Terminal.
Issues within a course:
Stuck on a step
There’s various issues that make it so you might not be able pass or run a step. The first thing you should try is using the reset button on CodeRoad. That will reset your progress to the beginning of the step you are on - you will have to do the step again. If that doesn’t work, try exiting the terminal and opening a new one.
Issues with your progress getting saved:
You finished a course but don’t see check mark next to it when going back to your freeCodeCamp account
Refresh the page to see if that works. A page refresh is required before you see the check mark.
The checkmark still didn’t show up
After the last step of a course, you will see a ‘continue’ button to finish it:
Clicking ‘continue’ is what triggers your progress to get saved. There’s a chance you didn’t click it or something went wrong. Open your finished course back up and it should take you to that screen. Click the continue button again to save your progress to your freeCodeCamp account.
Still no check mark?
Your user token is used to save your progress. As a security measure, we delete them when you sign out of freeCodeCamp. A new token is created again when you open up one of the projects, but existing VM’s still have the old token until it shuts itself down. Open up a different project to shut down your running VM. Then go open the old project back up; the container should now have your new token. If you finished the project, it should take you right to the screen in the image above. Press that continue button to submit the project again. If this is the issue, it should now be saved and show up the next time you refresh your freeCodeCamp page.
Other issues:
You are stuck in some other way
Create a new topic on the forum and someone can help you troubleshoot the problem
Last resort:
If all else fails, you can delete your container and start over
As a last resort, you can go to your CodeAlly dashboard and delete the container with the name of the tutorial that is problematic. Unfortunately, you will have to start the tutorial from the beginning if you do this. Note: the dashboard may not update until you refresh the page.
