Infrastructure

• MIT provides instructions to setup the tools directly on Linux/Mac and Windows. You are permitted to follow these instructions directly if you do not want to use container.

• For this class’ materials, we will be using running a Docker container with additional privilege to emulate the ability to interact with the OS system calls.

• It should be noted that once we access the running container via the terminal, everything should be the same regardless of the setup choice.

Setup Docker

• If you have not used Docker Desktop before, you can go over the instruction on how to setup Docker Desktop at Docker for Classroom: Quick Setup Reminder.

---

Setup

Fall 2025 students

This setup has been updated and simplified. If you have setup the CSC331 environment already, you should carry out the following steps to reset and repull/rebuild your images.

• First, stop all running containers (login and csc331).
• Clean up all stopped containers (type y and press Enter when asked)

1
 
docker container prune
 

• Remove the previous images

1
2
 
docker image rm linhbngo/onering:login
docker image rm linhbngo/onering:csc331
 

• Clone the repository (if you don’t have it already)

1
2
3
 
git config --global core.autocrlf false
git clone https://github.com/ngo-classes/the-one-ring
cd the-one-ring
 

• Pull the images

1
2
 
docker image pull linhbngo/onering:csc331
docker compose -f docker-compose.yml up csc331
 

Test

• We first test the ability to access the browser-based Code server environment by open a browser and visit 127.0.0.1:18088 or localhost:18088.
  • Enter goldenrams as the password to login.
  • You should see the Code server browser view of /home/student

• You can also ssh into the container from your host computer’s terminal via the port 22331.
  • While there is a built-in terminal inside the Code browser, sometimes additional separate terminal instances will be useful for this class.

1
 
ssh -p 22331 student@localhost