> 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/archive-installation.md).

# Archive installation of Pentaho

If you are installing Pentaho in a production environment, use and archive installation to install the Pentaho Server on a server machine while installing design tools on separate client workstations.

You must also choose a Pentaho Repository database, then install it yourself.

By default, the archive installation includes:

* BA plugins (such as Analyzer and Interactive Reports).
* DI plugins (such as Big Data and Marketplace).

The archive installation includes a preconfigured Tomcat web application server.

Use an archive installation when you do not already have an application server.

For a deployment on an existing application server, see [Manual installation](/install/pentaho-installation-overview-cp/manual-installation.md).

An archive installation is also useful if you already have Pentaho data or repositories from a previous version.

### Prerequisites

This guide assumes that you:

* Reviewed installation options in [Pentaho installation](/install/pentaho-installation-overview-cp.md).
* Checked supported platforms in [Components Reference](/install/components-reference.md).
* Uninstalled any evaluation version of Pentaho.
* Disabled antivirus software during installation.

### Audience

IT administrators who know the data environment and can run Windows or Linux commands.

### Tools

You need a text editor and a ZIP tool.

You must provide:

* A supported operating system and Java runtime.
* A Pentaho Repository database (PostgreSQL, MySQL, MariaDB, MS SQL Server, or Oracle).
* JDBC drivers for the database you choose.

### Login credentials

Use an account with administrative privileges.

Linux users might need `root` for some steps.

### Requirements for archive installation

An archive installation requires these items and expertise:

| Requirements                  | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| ----------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| You Supply                    | <p>Each of the following items must meet or exceed the requirements in the <a href="/spaces/qfaQ2p0JAZrP8b3cpM9a/pages/UYdICl9vPkhPf6bT2WCV">Components Reference</a>:- Computer with a supported operating system and hardware configuration.</p><ul><li>Oracle Java Runtime Environment (JRE) or Oracle Java Development Kit (JDK).</li><li>Pentaho Repository database (PostgreSQL, MySQL, MariaDB, MS SQL Server, or Oracle). You can also use a preexisting Pentaho repository platform.</li><li>Pentaho Repository database JDBC drivers (PostgreSQL, MySQL, MariaDB, MS SQL Server, or Oracle).</li></ul> |
| We Supply                     | <ul><li>Installation package.</li><li>The web application server (Tomcat).</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| Technologies Used             | <ul><li>Tomcat web application server (provided by Pentaho).</li><li>A PostgreSQL, MySQL, MariaDB, MS SQL Server, or Oracle database.</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| Expertise                     | <ul><li>Knowledge of your networking environment, including database port numbers if they differ from the default and IP address.</li><li>Permission to access installation directories.</li><li>Root or administrative access.</li></ul>                                                                                                                                                                                                                                                                                                                                                                        |
| Approximate Installation Time | <ul><li>60 to 90 minutes.</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |

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

### Archive installation process

Use this guide to install Pentaho Server using the archive (ZIP) distribution.

Archive installation includes a bundled Tomcat web application server.

If you need to deploy on an existing application server, see [Manual installation](/install/pentaho-installation-overview-cp/manual-installation.md).

Install Pentaho Server using the archive (ZIP) distribution, by completing the following tasks, in order:

1. [Prepare your environment](/install/pentaho-installation-overview-cp/archive-installation/step-1-prepare-your-environment.md)

   Set up prerequisites on Windows or Linux.
2. [Set up the Pentaho Repository](/install/pentaho-installation-overview-cp/archive-installation/step-2-set-up-the-pentaho-repository.md)

   Initialize and configure the repository database (PostgreSQL, MySQL/MariaDB, Oracle, or MS SQL Server).
3. [Start Pentaho Server and install licenses](/install/pentaho-installation-overview-cp/archive-installation/step-3-start-pentaho-server-and-install-licenses-and-client-tools.md)

   Start the Pentaho-provided Tomcat instance, then sign in to the Pentaho User Console.


---

# 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/archive-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.
