Infrastructure

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

Preliminary

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)

 docker container prune
 

Remove the previous images

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

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

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

Pull the images

 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.

 ssh -p 22331 student@localhost
 