Home/Resources/Building Enterprise Websites with Liferay and AI prerequisites

Training

Building Enterprise Websites with Liferay and AI prerequisites

Five steps to get your computer, tools and downloads ready before the two-day course. Tick each item as you go: your progress is saved in this browser.

About the course

Over two days you build Clarity Vision Solutions' public website on Liferay DXP 2026.Q3: users and permissions, sites, pages and master pages, fragments, styling, CMS content, collections, commerce, headless APIs, workflow and publishing, search, Objects and personalization. You build it with an AI coding agent: each exercise gives you a prompt for the agent, then you check the result yourself in Liferay.

Bring a laptop you can install software on, and an AI coding agent you already have access to. The course doesn't provide an AI subscription. The course repository and workbook are shared on the first morning.

Prepare your computer

Install and check each item below. Run the commands in a terminal: the Terminal app on a Mac or Linux, or PowerShell on Windows.

Based on Liferay's classroom training prerequisites.

  • Any recent version. You don't need a GitHub account.

    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
  • 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

    If java -version shows another version, set the JAVA_HOME environment variable to your JDK 21 folder and put its bin folder first in your PATH, then open a new terminal.

    Check it

    java -version
    javac -version

    You should see something like:

    openjdk version "21.0.5" 2024-10-15 LTS
    javac 21.0.5
  • 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 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
  • Liferay DXP, its search engine and the PostgreSQL database run on your computer, next to your editor and browser. You need 16 GB of memory installed, with at least 8 GB free on the day. Close other heavy applications during the course.

  • A company laptop may block installs, Docker or local servers. Check with your IT team before the course, and ask them to allow ports 8080 and 5432 on localhost.

  • Working through this Liferay Learn course first lets the workshop move faster and go deeper.

Install Docker

Docker is required. The course runs its PostgreSQL database in a Docker container, next to Liferay DXP.

  • Docker Desktop on Windows and macOS, or Docker Engine with the Compose plugin on Linux. Start it before you check it.

    How to install

    Windows

    Install Docker Desktop for Windows, or run the command below. Restart when asked, then start Docker Desktop.

    winget install --id Docker.DockerDesktop -e

    macOS

    Install Docker Desktop for Mac for your chip (Apple silicon or Intel), or use Homebrew. Then open Docker from Applications.

    brew install --cask docker

    Linux

    Install Docker Engine and the Compose plugin for your distribution, then let your user run Docker without sudo: sudo usermod -aG docker $USER, and sign out and back in.

    Docker Desktop's license is free for personal use, education and small businesses. Larger companies need a paid subscription: check with your IT team.

    Check it

    docker compose version
    docker run --rm hello-world

    You should see something like:

    Docker Compose version v2.29.1
    ...
    Hello from Docker!
    This message shows that your installation appears to be working correctly.

Download ahead of time

These downloads are about 1.5 GB. Do them at home or the office, so the course doesn't depend on the venue's Wi-Fi.

  • Save it in Liferay's download cache, where the course workspace finds it instead of downloading it again. It's about 1.3 GB.

    How to download

    macOS and Linux

    mkdir -p ~/.liferay/bundles
    curl -L -o ~/.liferay/bundles/liferay-dxp-tomcat-2026.q3.10-1793707249.7z https://releases-cdn.liferay.com/dxp/2026.q3.10/liferay-dxp-tomcat-2026.q3.10-1793707249.7z

    Windows (PowerShell)

    New-Item -ItemType Directory -Force "$HOME\.liferay\bundles"
    curl.exe -L -o "$HOME\.liferay\bundles\liferay-dxp-tomcat-2026.q3.10-1793707249.7z" https://releases-cdn.liferay.com/dxp/2026.q3.10/liferay-dxp-tomcat-2026.q3.10-1793707249.7z

    Check it

    The file liferay-dxp-tomcat-2026.q3.10-1793707249.7z in ~/.liferay/bundles (%USERPROFILE%\.liferay\bundles on Windows) is about 1.3 GB. If it's much smaller, the download was interrupted: delete it and run the command again.

  • The database the course runs in Docker. Start Docker first.

    Download and check it

    docker pull postgres:16
    docker image ls postgres

    You should see something like:

    REPOSITORY   TAG   IMAGE ID       CREATED       SIZE
    postgres     16    3f8b2c1d9a7e   2 weeks ago   453MB
  • The organizers email you an activation key file (activation-key-….xml) before the course. Save it somewhere you can find it on the first morning. It's for your own use during the course: don't share it or commit it to a repository.

Install your tools

You'll work in a Liferay Workspace in VS Code, with an AI coding agent at your side. Bring the agent you already have access to: it must have an agent mode that can run terminal commands and connect to an MCP server. One is enough, and ticking it completes this choice.

  • Or another editor your agent works in. The workbook's instructions use VS Code.

  • Sign in with a Claude plan or account that includes Claude Code.

  • Sign in with your ChatGPT account. Codex comes with paid ChatGPT plans.

  • Sign in to VS Code with the GitHub account that has your Copilot access, and use the Chat view in Agent mode.

  • Any agent that reads Agent Skills from an .agents/ folder, runs terminal commands in your workspace and connects to an HTTP MCP server.

Check everything with your AI agent

Let the AI agent you installed in step 4 check your setup for you. It runs the checks in a terminal and tells you what passes and what to fix. It's also a good first test that your agent works.

  1. In VS Code, open any folder (File → Open Folder), for example your home folder or a new empty one.
  2. Open your AI agent'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 agent asks to run a command, allow it: the checks only read information.
Prompt
Check that my computer is ready for the Building Enterprise Websites with Liferay and AI course. First tell me my operating system and shell. Then run each check in the terminal, one at a time. Don't install, update 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. Docker: run `docker compose version` and `docker info --format "{{.ServerVersion}}"`. PASS if Compose is installed and the Docker engine answers (so it's running).
5. PostgreSQL image: run `docker image ls postgres:16`. PASS if the image is listed.
6. DXP bundle: look for liferay-dxp-tomcat-2026.q3.10-1793707249.7z in the .liferay/bundles folder of my home folder. PASS if it exists and is larger than 1 GB.
7. Memory: report the total and the currently available RAM. PASS if at least 16 GB is installed and 8 GB is available; WARN if less is available now.
8. Disk: check the free space on the drive with my home folder. PASS if at least 20 GB is free.
9. Ports: check whether anything is already listening on ports 8080 and 5432. PASS if both are free; otherwise WARN and tell me which program uses them.

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 on my operating system.

Finally, list what I need to confirm myself, because you can't check it: that I received my Liferay DXP activation key by email, and that I can install software and run Docker on this computer during the course.
  • Run the check, fix anything marked FAIL or WARN, and run it again until everything passes. Then confirm the items it lists.

Something not working, or your activation key hasn't arrived? Contact the course organizers, or see Get help.