Skip to main content
Hitachi Vantara Lumada and Pentaho Documentation

Docker container deployment of Pentaho

Parent article

This guide walks you through setting up and deploying Pentaho products within complete, cloud-ready Docker containers. You can use your Pentaho Server, based on your licensed Pentaho software, to create a standardized Docker container with data integration, business analytics, and Carte server components. For example, you can set up Pentaho Data Integration (PDI) containers, then quickly deploy those containers in the cloud to run your data transformation workloads, which enhances performance and cost-efficiency of your cloud environment. Supported Pentaho components include the Pentaho Server (Business Analytics and Data Integration), the Carte server, and the Kitchen and Pan command line tools.

Before you begin

Before you start creating and deploying your Docker containers of Pentaho products, be sure your system meets the following requirements:

  • Installation artifacts (ZIP files) of the Pentaho 9.3 products you are deploying through Docker containers. See Pentaho installation for instructions about downloading installation artifacts of Pentaho products.
  • An installed and stable Docker instance. This instance must have docker-compose installed to support the docker-compose.yml. If you are on a Windows operating system, you must have WSL2 installed and active.
  • A user account with The account login must be configured using the docker login command so that Docker can access registered database containers.
  • The curl command line tool must be installed on the host operating system.
  • If you want to download Oracle databases, you must have login credentials to Oracle’s container repository.
  • Pentaho licenses must be installed on the host, and the environment variable PENTAHO_INSTALLED_LICENSE_PATH must point to the installedLicenses.xml file. See Manage Pentaho licenses for more information.
  • Java 8 or 11 must be installed on the host machine.

IT administrators who know where the data is stored, how to connect to it, details about the computing environment, and how to use the command line to issue commands for Microsoft Windows or Linux.

Login credientials

You must be logged on to an account that has privileges to perform the tasks in these sections. Additionally, Linux users need to use sudo privileges or Docker roles for some tasks.

Docker container deployment process

Use the DockMaker command line tool to set up and deploy Docker containers of Pentaho products. Instructions for using this tool are located in the DockMaker Tool Tech Doc.docx file, which is a part of the file you download from the Hitachi Vantara Lumada and Pentaho Support Portal.

Perform the following steps to download the file and access the DockMaker Tool Tech Doc document.


  1. On the Customer Portal home page, sign in using the Pentaho support user name and password provided in your Pentaho Welcome Packet.

  2. Click Downloads, then click Pentaho 9.3 GA Release in the 9.x list.

  3. Navigate to Utilities and Tools DockMaker Tool, then download the file.

  4. Unzip the downloaded ZIP file.

  5. Run the for Linux or the install.bat for Windows to unpack and then install dockMaker.

  6. Open the DockMaker Tool Tech Doc.docx file and follow the specific instructions for your deployment.