Prerequisites

1. Docker Engine
2. VS Code and the Dev Containers extension
3. Git

How to Run a Project in Docker

1. Clone the RDB Alpha repo with git clone https://github.com/freeCodeCamp/rdb-alpha
2. Open a terminal, navigate to the rdb-alpha directory, and open VSCode with code .
3. Press Ctrl / Cmd + Shift + P and enter Dev Containers: Rebuild Container and Reopen in Container
4. A new VS Code window will open and begin building the Docker image. It will take several minutes to build the first time.
5. Once the image is finished building, press Ctrl / Cmd + Shift + P and enter CodeRoad: Start to open CodeRoad
6. In the CodeRoad window, click "Start New Tutorial"
7. Enter the URL to the tutorial.json file of the project you want to start (ex: https://raw.githubusercontent.com/freeCodeCamp/learn-bash-by-building-a-boilerplate/main/tutorial.json)
8. Click the "Start" button

There may be some additional troubleshooting steps to get the container running properly. They can often be solved by following the onscreen instructions, or examining any error messages in your terminal.

How to Restart or Switch Projects

Note: If you restart or switch projects you will lose your progress, along with any files or directories you created.

1. Press Ctrl / Cmd + Shift + P and enter Dev Containers: Rebuild Container
2. Wait for VS Code to reopen and reload the Docker container
3. Open CodeRoad, enter the URL to a tutorial.json file, and start the project as described above

tutorial.json File URLs for CodeRoad

• Learn Bash by Building a Boilerplate
• Learn Relational Databases by Building a Database of Video Game Characters
• Celestial Bodies Database
• Learn Bash Scripting by Building Five Programs
• Learn SQL by Building a Student Database: Part 1
• Learn SQL by Building a Student Database: Part 2
• World Cup Database
• Learn Advanced Bash by Building a Kitty Ipsum Translator
• Learn Bash and SQL by Building a Bike Rental Shop
• Salon Appointment Scheduler
• Learn Nano by Building a Castle
• Learn Git by Building an SQL Reference Object
• Periodic Table Database
• Number Guessing Game