Installation instructions on MacOS

Step 0: Adjusting your keyboard language

While using the software for this course, your computer’s keyboard language must be set to English. If needed, please follow these instructions to change your keyboard language.

Step 1: Install VSCodium

Before downloading VSCodium, determine whether your Mac uses Apple silicon or an Intel processor. You can also consult Apple’s list of Mac computers with Apple silicon.

1. Select the Apple menu in the upper-left corner of the screen.

2. Select About This Mac.

3. On a Mac with Apple silicon, About This Mac shows an item labeled Chip, followed by the name of the chip (for example, Apple M1).

4. On an Intel-based Mac, About This Mac shows an item labeled Processor, followed by the name of an Intel processor (for example, Intel Core i5).

Then install VSCodium:

1. Go to the VSCodium releases page.

2. Scroll down to the table of download links for the latest release, and download the appropriate .dmg file::

   • Apple Silicon Macs: choose the file whose name begins with VSCodium.arm64 and ends with .dmg.

   • Intel Macs: choose the file whose name begins with VSCodium.x64 and ends with .dmg.

3. Go to your Downloads folder and double-click the .dmg file that you downloaded.

4. Drag the VSCodium icon into the Applications folder.

5. Launch VSCodium

   • The first time that you open VSCodium, macOS may warn you that the application was downloaded from the Internet. Click Open to confirm you want to open it.

Step 2: Install a JDK

Java programs are compiled and run using a tool called the Java Development Kit, or JDK. For this course, please install a recent version (25 or newer).

After a JDK is installed, the javac and java commands become available.

On macOS, install OpenJDK using SDKMAN. SDKMAN installs Java in your home folder and updates your shell so that commands like java and javac use the installed JDK.

1. Launch VSCodium.

2. Open VSCodium’s built-in Terminal pane. You can do this by pressing the Control key and the backtick key, or by selecting Terminal->New Terminal from the menu.

3. In the Terminal, install SDKMAN by typing the following command and pressing Enter:

   curl -s "https://get.sdkman.io" | zsh
   

   Follow the on-screen instructions.

4. When the SDKMAN installer is finished, close the current Terminal pane and open a fresh Terminal pane in VSCodium.

5. In the new Terminal pane, confirm that SDKMAN is working by typing the following command and pressing Enter:

   sdk version
   

6. Install OpenJDK by typing the following command and pressing Enter:

   sdk install java
   

   SDKMAN installs the latest stable Java release using Eclipse Temurin by default. If SDKMAN asks whether this version should be set as the default, press Enter.

Step 3: Verify the JDK Installation

1. If VSCodium is not already open, launch it.

2. Open VSCodium’s built-in Terminal pane. You can do this by pressing the Control key and the backtick key, or by selecting Terminal->New Terminal from the menu.

3. In the Terminal, type the following command and then press Enter:

   java -version
   

   You should see output that looks similar to this:

   > java -version
   openjdk version "25.0.1" 2025-10-21 LTS
   OpenJDK Runtime Environment Temurin-25.0.1+8 (build 25.0.1+8-LTS)
   OpenJDK 64-Bit Server VM Temurin-25.0.1+8 (build 25.0.1+8-LTS, mixed mode, sharing)
   

The exact version may be different, but the output should include “Temurin” and a recent Java version number.

Last updated on September 7, 2026.