You can install Blade CLI using the Liferay Project SDK installer. This installs JPM and Blade CLI into your user home folder and optionally initializes a Liferay Workspace folder.

If you need to configure proxy settings for Blade CLI, follow the Installing Blade CLI with Proxy Requirements

Follow the steps below to download and install Blade CLI:

  1. Download the latest Liferay Project SDK installer that corresponds with your operating system (e.g., Windows, MacOS, or Linux). The Project SDK installer is listed under Liferay IDE, so the folder versions are based on IDE releases. You can select an installer that does not include Dev Studio CE, if you don’t intend to use it. The Project SDK installer is available for versions 3.2.0+. Do not select the large green download button; this downloads Liferay Portal instead.

  2. Run the installer. Click Next to step through the installer’s introduction.

  3. If you’d like to initialize a Liferay Workspace, you can set the directory where it should go.


    Figure 1: Determine where your Liferay Workspace should reside, if you want one.

    Select the Don’t initialize Liferay Workspace directory option if you only want to install Blade CLI. Then click Next.

  4. If you decided to initialize a Liferay Workspace folder in the previous step, you’ll have an additional option to select the Liferay product type you’ll use with your workspace. Choose the product type and click Next.


    Figure 2: Select the product version you’ll use with your Liferay Workspace.

  5. Click Next to begin installing Blade CLI/Liferay Workspace on your computer.

That’s it! Blade CLI is installed on your machine! If you specified a location to initialize a Liferay Workspace folder, that is also available.

Blade CLI offers many templates to help build Liferay Portal CE 7.1 applications. It also offers various ways to deploy those apps and interact with your Liferay server. Be sure to explore more Blade CLI tutorials to learn how.

Installer Issues on macOS/Linux

If you’re using macOS or Linux, you could experience an issue where the blade command is not available via command line. This is caused by the installer being unable to add JPM’s bin folder to your user path. JPM is a Java package manager used in Blade CLI.

To add the required bin folder, execute the appropriate command based on your operating system.


echo 'export PATH="$PATH:$HOME/Library/PackageManager/bin"' >> ~/.bash_profile


echo 'export PATH="$PATH:$HOME/jpm/bin"' >> ~/.bash_profile

Once you restart the command line, the blade command should be available.

0 (0 Votes)
Blade CLI Previous