# 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: 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:

```
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>
```

The question should be specific, self-contained, and written in natural language.
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.