Liferay Masterclass prerequisites

Based on Liferay's classroom training prerequisites.

• Git

  Any recent version. You don't need a GitHub account for this part.

  How to install

  Windows

  Install Git for Windows from git-scm.com, or run the command below. During setup, choose to use Git from the command line and also from third-party software.

  winget install --id Git.Git -e

  macOS

  Run the command below and click Install when macOS asks. With Homebrew, you can run brew install git instead.

  xcode-select --install

  Linux

  On Ubuntu or Debian:

  sudo apt install git

  Check it

  git version

  You should see something like:

  git version 2.44.0

• Java JDK 21

  A JDK, not just a JRE, reporting a 21.x version.

  How to install

  Windows

  Install Microsoft Build of OpenJDK 21:

  winget install Microsoft.OpenJDK.21

  macOS

  With Homebrew:

  brew install --cask microsoft-openjdk@21

  Linux

  On Ubuntu or Debian:

  sudo apt install openjdk-21-jdk

  Prefer a ZIP or TAR.GZ? Download OpenJDK 21 from Microsoft, extract it to a folder of your choice and set the JAVA_HOME environment variable to that folder. Open a new terminal afterwards. If java -version shows another version, set JAVA_HOME to your JDK 21 folder and put its bin folder first in your PATH.

  Check it

  java -version
  javac -version

  You should see something like:

  openjdk version "21.0.5" 2024-10-15 LTS
  OpenJDK Runtime Environment Microsoft-10377968 (build 21.0.5+11-LTS)
  OpenJDK 64-Bit Server VM Microsoft-10377968 (build 21.0.5+11-LTS, mixed mode, sharing)
  javac 21.0.5

• Liferay Blade CLI

  Version 7.0 or later, which Liferay DXP needs to work with JDK 21. Install the JDK first.

  How to install

  macOS and Linux

  Run the command below. When it says Blade installed successfully, open a new terminal. If blade isn't found, add the folder the installer shows to your PATH.

  curl -L https://raw.githubusercontent.com/liferay/liferay-blade-cli/master/cli/installers/local | sh

  Windows

  Download and run the Liferay Project SDK installer: it detects your Java and adds blade to your PATH. If you use Git Bash, you can run the macOS and Linux command instead.

  If your version is older than 7.0, update it:

  blade update

  Check it

  blade version

  You should see something like:

  blade version 7.0.3

• 4 GB of free memory and 10 GB of free disk space

  Enough to run Liferay DXP on your computer during the workshop. Close other heavy applications on the day.

• Recommended: the Learning Path on Liferay Learn

  Working through the matching Liferay Learn Learning Path first lets the workshop move faster and go deeper.

• Visual Studio Code

  VS Code makes it easy to work with your Liferay Workspace.

• Choose one AI assistant
• Claude Code extension for VS Code

  With the extension installed, you've got Claude at your fingertips in VS Code.

• OpenAI Codex extension for VS Code

  Codex, OpenAI's coding agent, comes with your ChatGPT plan: sign in to the extension with your ChatGPT account.

• GitHub Copilot in VS Code

  Sign in to VS Code with the GitHub account that has your Copilot access.

• ngrok account

  AI Hub and LDP both need to reach your Liferay DXP instance on a public URL, and ngrok provides it. Create an account with your email address so we can add you to our Liferay Enablement ngrok account.

• Liferay Marketplace account

  You'll need it to download new product license files for CMP/DSR.

• AI Hub account

  An invitation to join AI Hub for the training.

• LDP workspace access

  An invitation to join an LDP workspace for the training.

• Workshop repository on GitHub

  An invitation to the repository with the workbook you'll be testing and its context source materials. Until you accept it, the link shows "Page not found". Once you've accepted, clone it:

  git clone https://github.com/liferay/liferay-course-masterclass.git

• Workbook

  It's in the workshop repository, at context-source/liferay-skills-learning-path.html. Open it from your clone, or on GitHub once you have access.

1. In VS Code, open the folder with your clone of the workshop repository (File → Open Folder).
2. Open your AI assistant's chat:
   • Claude Code: click the Claude icon, or run Claude Code: Open from the Command Palette.
   • OpenAI Codex: click the Codex icon in the sidebar.
   • GitHub Copilot: open the Chat view and switch the mode to Agent, so Copilot can run commands.
3. Copy the prompt below, paste it into the chat and send it. When the assistant asks to run a command, allow it: the checks only read information.

Check that my computer is ready for the Liferay Masterclass. Run each check in the terminal, one at a time. Don't install or change anything.

1. Git: run `git version`. PASS if Git is installed.
2. Java: run `java -version` and `javac -version`. PASS if both report version 21.x (a JDK, not just a JRE).
3. Blade: run `blade version`. PASS if it's 7.0 or later.
4. Memory: check the free RAM. PASS if at least 4 GB is available.
5. Disk: check the free space on the drive with my home folder. PASS if at least 10 GB is free.
6. Workshop repository: find my clone of github.com/liferay/liferay-course-masterclass (in the open folder or my home folder). PASS if it exists and contains context-source/liferay-skills-learning-path.html.
7. ngrok: run `ngrok version` and `ngrok config check`. PASS if ngrok is installed and has an auth token; otherwise WARN.

Then show the results as a table with the columns Check, Result (PASS, WARN or FAIL) and Details. For anything that isn't PASS, tell me how to fix it.

Finally, list what I need to confirm myself, because you can't check it: my Liferay Marketplace account, and my AI Hub, LDP workspace and GitHub invitations.

• All checks show PASS

  Run the check below, fix anything marked FAIL or WARN, and run it again until everything passes. Then confirm the accounts and invitations it lists.