Skip to main content

Pentaho+ documentation has moved!

The new product documentation portal is here. Check it out now at


Hitachi Vantara Lumada and Pentaho Documentation

Launching Pentaho in AWS


You can launch a new Pentaho Amazon Machine Image (AMI) from the AWS Marketplace. To use the Pentaho AMI, you must create a customized security group and select or create an SSH key pair during the launch configuration. You can then install your licenses to activate the software after you launch an instance of the AMI.

Find and configure the Pentaho AMI

If you found us through the Marketplace Search Page, your flow and prompts will differ, but you can end up with the same result. When prompted, you select Launch Via Ec2 to follow that flow.

Launch the Pentaho AMI instance

Perform the following steps to launch an instance of the Pentaho AMI from the EC2:AMI Catalog


  1. Select the AMI Catalog from the EC2 menu and search the AWS Marketplace AMIs for the Pentaho AMI.

  2. Select to view the AMI you want to launch.

  3. Review the product details and terms, then select the AMI you want to use, and press Continue.

  4. Click Launch Instance from AMI.

    The EC2 Launch screen opens.
  5. Name your new server.

  6. Select your instance type.

  7. In the Key pair (login) section of the Launch an instance page, select Choose an existing key pair if you already have a valid key pair, or select Create a new key pair to create a new one.

    • Choose an existing key pair: Select a key pair from the list of available key pairs.
    • Create a new key pair: Enter a name for the key pair and click Create. The private key file will be downloaded automatically to your local computer. Be sure to store the private key file in a secure location, as you will need it to connect to the instance using SSH.
  8. Set port 22 for SSH access and allow traffic from your desired IP addresses in the Network Settings Create security group option.

  9. Create a new rule or edit existing rules or to allow traffic on port 8080 from your desired IP addresses or IP ranges.

    NoteYou do not need to adjust the attached disk volumes in Configure storage.
  10. Review the launch configuration and click Launch instance to start the instance.

Next steps

Once the instance is running, you can connect to it using SSH and the private key file for the key pair you selected or created.

Apply licenses

After launching an instance of the Pentaho AMI, perform the following steps to apply your Pentaho licenses to the instance:


  1. Copy or download the Pentaho license files to your local computer.

    NoteIf you do not already have your Pentaho license keys, you can obtain them from your Pentaho sales representative in the form of Pentaho license files.
  2. Navigate to the Pentaho Server at http://<private ip>:8080

  3. Log in as the Evaluation Admin User.

    You are redirected to the License Management page in the Administrative perspective.
  4. Click the Add (+) icon in License Keys to add a new license.

  5. Click Choose Files.

    1. Select the server license file from your local computer.

    2. Click Upload to upload the license keys.

    After you enter the server license key, the Pentaho Server activates, and you are redirected to the Home page in the Pentaho User Console.
  6. (Optional) Navigate back to the License Management page to complete any additional license key entries needed.


Your Pentaho AMI is licensed and ready to use.

See also


Also refer to the follow information regarding administration of the Pentaho installation, upgrades, and client tools

Administration of Pentaho in the AMI instance


The Pentaho software is owned by the pentaho user. A PostgreSQL repository is also installed on this instance and owned by the postgres user. Neither user has a password. You can only access these users via the sudo command.

The Pentaho software and the PostgreSQL data files are installed on the second volume (/install). The /install/pentaho directory is symlinked to the /opt/pentaho directory.

Pentaho Server


Pentaho is installed as an auto-start service in your AMI instance. To check the status of the Pentaho Server, SSH to the machine and run the following command:

sudo systemctl status pentaho

See Logging and performance monitoring and Troubleshooting for further details on maintaining the Pentaho Server.



See Pentaho upgrade for instructions on how to apply service packs and upgrades with the Pentaho Upgrade Installer.

Client tools


The following information helps to extend your knowledge of client tool installation, the Pentaho Repository, and run configurations of remote jobs from the Pentaho Data Integration (PDI) client (also known as Spoon):