> 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/pdia-try-pdia/archive-flattened-pages-do-not-use/install-trial-legacy-child-pages/custom-installation.md). # Custom installation If you choose the **Let me decide for myself.** installation method, complete the following steps. If you want to install using the default method, read the Default Installation instructions. **Note:** You cannot install into a directory that already exists. If you attempt to install into a directory that exists, an error message appears. If you are using Linux, the best practice is to not install the software in the `/opt/` directory. The complicated permissions requirements and general isolation from the rest of the system might cause problems if the software is installed in this location. 1. After you start the installation wizard, the Pentaho Business Analytics Installation Wizard splash screen appears, then the Pentaho Business Analytics installation is ready! window. Click **Next**. 2. Read the license agreement. Click **Accept**, then click **Next** to continue. 3. Select the **Let me decide for myself** option in the **Setup Type** window, and then click **Next**. 4. In the Pentaho Applications window, select the Pentaho components that you want to install in the **Install Set** panel then click **Next**. 5. If you chose to install the Pentaho Server, then the Sample Content window appears. Sample content includes users, reports, dashboards, and analysis views which can be useful when evaluating the product. * Select **Sure, give me sample content** to include this sample content with your installation. * Select **No thanks, I'll create my own** to exclude the sample content. 6. Click **Next**. 7. In the Installation folder window, accept the default directory or choose a different directory by entering the path in the **Location** text box where you want to install the software. Click **Next**. 8. If you selected to install the Pentaho Server, you are prompted to add a Postgres SQL password. Enter and confirm the password you want to assign to the `postgres` user who is assigned admin privileges for the PostgreSQL database. **Note:** Do not use these characters in the **Password** field because the installation wizard cannot process them: ``` ' " & < > \ ``` 9. Click **Next** to continue. 10. If the Sample Database window appears, enter a port number in the **Port** field to use for the database which will house sample content, then click **Next** to continue. The port request only appears if the Pentaho Server default port numbers (8080, 9092, 8443, 9443, and 5432) are not available on your system and if the additional ports that the installer has tried are not available. 11. When the Ready to Install window appears, click the **Next** button to install the software. The Installation in Progress window appears. The software takes approximately 30 minutes to install. **Note:** An error occurs if Pentaho Server port numbers (8080, 9092, 8443, 9443, and 5432) are not available on your system and if the additional ports that the installer has tried are not available. If the installer cannot find an available port, you are prompted to enter port numbers you want to use. 12. When installation is complete, the final window appears. Select the **Pentaho User Console** and **Pentaho Data Integration** check boxes to launch the Pentaho User Console and Pentaho Data Integration (PDI). 13. Click **Finish** to end the process. **Note:** If you have trouble with the installer, see the Administer Pentaho Data Integration and Analytics document for details. After the installation is complete, the Pentaho Server runs with the default parameters. Terminal windows might remain open after installation. If you close them, the Pentaho Server stops. On Windows, the Pentaho Server is installed as a system service, meaning that it starts when you start your computer and stops when you shut down your computer. The User Console, Spoon, and other tools must be manually run. --- # 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/pdia-try-pdia/archive-flattened-pages-do-not-use/install-trial-legacy-child-pages/custom-installation.md?ask=&goal= ``` `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.