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 -emacOS
Run the command below and click Install when macOS asks. With Homebrew, you can run
brew install gitinstead.xcode-select --installLinux
On Ubuntu or Debian:
sudo apt install gitCheck it
git versionYou 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.21macOS
With Homebrew:
brew install --cask microsoft-openjdk@21Linux
On Ubuntu or Debian:
sudo apt install openjdk-21-jdkIf
java -versionshows another version, set theJAVA_HOMEenvironment variable to your JDK 21 folder and put itsbinfolder first in yourPATH, then open a new terminal.Check it
java -version javac -versionYou 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
bladeisn't found, add the folder the installer shows to yourPATH.curl -L https://raw.githubusercontent.com/liferay/liferay-blade-cli/master/cli/installers/local | shWindows
Download and run the Liferay Project SDK installer: it detects your Java and adds
bladeto yourPATH.If your version is older than 7.0, update it:
blade updateCheck it
blade versionYou 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 -emacOS
Install Docker Desktop for Mac for your chip (Apple silicon or Intel), or use Homebrew. Then open Docker from Applications.
brew install --cask dockerLinux
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-worldYou 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.7zWindows (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.7zCheck it
The file
liferay-dxp-tomcat-2026.q3.10-1793707249.7zin~/.liferay/bundles(%USERPROFILE%\.liferay\bundleson 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 postgresYou 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.
- In VS Code, open any folder (File → Open Folder), for example your home folder or a new empty one.
- 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.
- 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.
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.