Setup Guide

Pre-Workshop Checklist

1. Required Installations

Tool	Verification Command
Java JDK 11+	`java -version && javac -version`
Git	`git --version`
Terminal/Shell	`ls` (should list files)

2. GitHub Account

Create free account: github.com/signup
Optional: Set up SSH keys (guide)

Setup Guide

Java Installation

Windows

Download Eclipse Temurin 11
Run installer → Add to PATH during installation
Verify:

java -version
# Should show "openjdk 11.x.x"

macOS

# Using Homebrew (recommended)
brew install temurin11

# Manual install
curl -L https://github.com/adoptium/temurin11-binaries/releases/download/jdk-11.0.20.1%2B1/OpenJDK11U-jdk_x64_mac_hotspot_11.0.20.1_1.tar.gz | tar xz

Linux (Ubuntu)

sudo apt update
sudo apt install openjdk-11-jdk

Git Installation

All Systems

# Windows (using Winget)
winget install Git.Git

# macOS
brew install git

# Linux
sudo apt install git

Terminal Setup

Platform	Instructions
Windows	1. Install Windows Terminal 2. Enable WSL (guide)
macOS	Use built-in Terminal (Finder → Utilities)
Linux	Use default terminal (Ctrl+Alt+T)

Pre-Workshop Verification

1. Full System Check

# Run in terminal
java -version && \
javac -version && \
git --version && \
echo $SHELL

Expected output:

openjdk 11.0.20 2023-07-18
OpenJDK Runtime Environment Temurin-11.0.20+8 (build 11.0.20+8)
OpenJDK 64-Bit Server VM Temurin-11.0.20+8 (build 11.0.20+8, mixed mode)

git version 2.41.0
/bin/zsh

2. GitHub Configuration

git config --global user.name "Your Name"
git config --global user.email "your@email.com"
git config --list  # Verify settings

Troubleshooting 🚑

Common Issues

Java Not Found:
- Windows: Re-run installer with “Add to PATH”
- macOS/Linux: Check echo $PATH contains Java bin
Git Authentication Failed:

# Use HTTPS instead of SSH
git config --global url."https://github.com/".insteadOf git@github.com:

Permission Denied (Linux/macOS):

chmod +x [*.sh]  # Repalce [*.sh] to the target file

Go Back to Homepage

Need Help? 🆘

Contact the host Yang Jiang at: jiang.yang1@northeastern.edu