Installing Docker (macOS)
First, determine if your Mac is using an Intel (x86) or Apple silicon (ARM) processor.
Apple silicon (M1 / ARM Mac)
Follow the instructions for the for the M1 here: https://docs.docker.com/docker-for-mac/apple-silicon/.
Note that support for Docker on Apple silicon is relatively recent, although we have managed to mitigate most issues, it is possible that you will still encounter some. If you run into strange issues during normal operation, please let the TAs know.
Intel processor (x86 Mac)
If your Mac is a 2010 model or newer and is running macOS El Capitan 10.11 or newer, you can head over to Docker’s website at the following link and follow the instructions to install the Community Edition of Docker: https://docs.docker.com/docker-for-mac/install/
If your Mac is older than 2010, please post privately on Ed Discussion / Piazza and we can discuss a solution.
Running the Docker container
- Make 100% sure you’re running the most recent version of MacOS and that you’ve rebooted your computer after installation before proceeding.
- Open the “Docker Desktop” application. Docker will start up, and the whale icon should eventually either turn green (yay it worked!) or red (error). If it comes up red, please ask a TA for help.
- There are some bugs with new features in macOS that can cause your files to
not show up correctly in Docker. Please go to the settings inside Docker,
and on
Choose file sharing implementation for your containers, ensure that VirtioFS is selected (and that gRPC FUSE isn’t). This only needs to be done once.
(If you are using an older version of Docker Desktop or don’t see the VirtioFS selection, there should instead be a checkbox labeled Use gRPC FUSE for file sharing. Uncheck it.) - After Docker has started, open the Terminal application, and use
cdto navigate to the directory in which you put thecs2110docker-c.shscript.- See Navigating the Terminal if you are not familiar with how to do this.
- Run the following command to give the Docker script permission to run (you only need to do this the first time):
sudo chmod +x cs2110docker-c.sh- Enter your password if prompted.
- Run the script by typing
./cs2110docker-c.sh.- This may take a moment if it is your first time running the script, but if everything goes as planned, you should see eventually that your user and path for your host machine should be replaced by something along the lines of
root@41c0750d2a18, with varying characters afterroot@.
- This may take a moment if it is your first time running the script, but if everything goes as planned, you should see eventually that your user and path for your host machine should be replaced by something along the lines of
Installation is done, and you have the container up and running! Finally, check out Using the CS 2110 Docker Container.