> 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-data-integration/9.3-data-integration/use-a-pentaho-repository-in-pdi/create-a-connection-in-the-pdi-client.md).

# Create a connection in the PDI client

If you want to access the repository items through the PDI client, perform the following steps to create a connection to a Pentaho Repository:

1. Verify the Pentaho Server is running, and start the PDI client.
2. Click **Connect** in the upper right corner of the PDI client toolbar.

   The Pentaho Repository welcome dialog box appears.

   ![Connect, PDI client toolbar](/files/EZEs3IDpizh452AjGQ7C)

   **Note:** If **Connect** is replaced by a different link name, you are already connected to a repository.
3. Click **Get Started**.
4. Enter or update the **Display Name** property.
5. Modify the URL associated with your repository, if necessary.
6. Click **Finish** to test the connection of your repository.

   If the test fails, make sure that the port number in the URL is correct. If you installed PDI using the Pentaho Installation Wizard, the correct port should appear in the `installation-summary.txt` file. The file is in the root directory where you installed PDI.

If the test is successful, you can either [**Connect Now**](https://github.com/pentaho/documentation/blob/main/PDIA/9.3/PDI/Use%20Pentaho%20repositories/Use%20a%20Pentaho%20Repository%20in%20PDI/Connect%20to%20a%20Pentaho%20Repository=GUID-5244FFC1-0371-4A78-8A4C-1B82958B87C7=1=en=.md), [**Manage Connections**](/pdia-data-integration/9.3-data-integration/use-a-pentaho-repository-in-pdi/manage-repositories-in-the-pdi-client.md), or **Finish** to close the dialog box. If you choose to finish, you can connect to the repository later through the menu next to the **Connect** link in the upper right corner of the PDI client toolbar.


---

# 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-data-integration/9.3-data-integration/use-a-pentaho-repository-in-pdi/create-a-connection-in-the-pdi-client.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.