> For the complete documentation index, see [llms.txt](https://docs.pentaho.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pentaho.com/install/pentaho-installation-overview-cp/manual-installation.md).

# Manual installation of Pentaho

Install Pentaho manually when you want to use your own Tomcat web application server in a production environment, particularly if you must comply with your company standard database platform or web application server.

If you are installing Pentaho in a production environment, you would use this method to install the Pentaho Server on a server machine while installing design tools on separate client workstations. It requires that you download and install Pentaho installation files.

You must also choose the Pentaho Repository database that you want to use, but you must download and install it yourself.

When you install the Pentaho Server using the manual method, you can choose which BA plugins you want to install (such as Analyzer and Interactive Reports).

### Before you begin

Review these prerequisites before you start the manual installation.

This guide assumes you have:

* Read the overview of installation options in [Pentaho installation](/install/pentaho-installation-overview-cp.md), to confirm this is the right option.
* Checked [Components Reference](/install/components-reference.md), to confirm your environment is supported.
* Uninstalled any evaluation version of Pentaho. See **Try Pentaho Data Integration and Analytics** for instructions.

#### Audience

IT administrators who understand data access and networking.

You should know how to use the command line on Windows or Linux.

You should also know how to install a database and a web application server.

#### Tools

You must supply a web application server that meets the requirements in [Components Reference](/install/components-reference.md).

You also need a text editor and a ZIP tool.

#### Sign-in requirements

You must be signed in with administrative privileges.

On Linux, you also need `root` access for some steps.

#### Manual installation requirements

* **You supply**
  * Supported OS and hardware.
  * Supported Oracle JRE or JDK.
  * Pentaho Repository database (PostgreSQL, MySQL/MariaDB, MS SQL Server, or Oracle).
  * JDBC driver for your chosen database.
  * Tomcat (or another supported web application server) for server installs.
* **We supply**
  * The Pentaho installation package.
* **Expertise**
  * Network and database configuration (ports, hostnames, IPs).
  * Directory access and permissions.
* **Time estimate**
  * 1–3 hours.

Download Pentaho from the [Support Portal](https://support.pentaho.com/home).

### Manual installation process

Manual installation deploys Pentaho Server to your own supported web application server (for example, Tomcat).

Review [Before you begin](#before-you-begin) before you start.

{% hint style="info" %}
**Note**: If you prefer an installation with a bundled web application server, see [Archive installation of Pentaho](/install/pentaho-installation-overview-cp/archive-installation.md).
{% endhint %}

#### Process overview

1. [Prepare your environment](/install/pentaho-installation-overview-cp/manual-installation/step-1-prepare-your-environment.md)
2. [Prepare your Pentaho Repository](/install/pentaho-installation-overview-cp/manual-installation/step-2-prepare-your-pentaho-repository.md)
3. [Configure and start the Pentaho Server after manual installation](/install/pentaho-installation-overview-cp/manual-installation/step-3-configure-and-start-the-pentaho-server-after-manual-installation.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.pentaho.com/install/pentaho-installation-overview-cp/manual-installation.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.