---
title: Connect to Tiger Data | Tiger Data Docs
description: Connect to Tiger Cloud, self-hosted TimescaleDB, or MST using any PostgreSQL client
---

To connect to your service or self-hosted TimescaleDB instance, you need at least the following:

- Hostname
- Port
- Username
- Password
- Database name

Once you have these, connect using any PostgreSQL client. Find the connection methods and details for your product:

- [Tiger Cloud](#tab-panel-609)
- [Self-hosted TimescaleDB](#tab-panel-610)
- [Managed Service for TimescaleDB](#tab-panel-611)

Connect to your Tiger Cloud service in any of these ways:

- **Data view or SQL editor in Tiger Console**: run queries in your browser, with no local client required.
- **`psql` or any other PostgreSQL client**: use the connection details below with `psql`, or any PostgreSQL-compatible client or SQL editor.

Retrieve the connection details for your Tiger Cloud service:

- **In `<service name>-credentials.txt`**:

  All connection details are supplied in the configuration file you download when you create a new service.

- **In Tiger Console**:

  Open the [`Services`](https://console.cloud.tigerdata.com/dashboard/services) page and select your service. The connection details, except the password, are available in `Service info` > `Connection info` > `More details`. If necessary, click `Forgot your password?` to get a new one.

  ![Service connection details in Tiger Console](/_astro/tiger-service-connection-details.CJPBXPtc_1UF10z.webp)

## Find your project and service ID

To retrieve the connection details for your Tiger Cloud project and Tiger Cloud service:

1. **Retrieve your project ID**

   In [Tiger Console](https://console.cloud.tigerdata.com/dashboard/services), click the arrows next to the project name in the top left. The project ID is under the project name.

   ![Retrieving the project ID in Tiger Console](/_astro/tiger-console-change-project.D-LN4vwi_1iqMB2.webp)

2. **Retrieve your service ID**

   Click the dots next to the service, then click `Copy` next to the service ID.

   ![Retrieving the service ID in Tiger Console](/_astro/tiger-console-service-id.KxfYxLWI_Z1bTfFh.webp)

## Create client credentials

You use client credentials to obtain access tokens outside of the user context.

To retrieve the connection details for your Tiger Cloud project for programmatic usage such as Terraform or the [Tiger Cloud REST API](/get-started/quickstart/cli-rest-api/index.md):

1. **Open the settings for your project**

   In [Tiger Console](https://console.cloud.tigerdata.com/dashboard/services), click `Settings`.

2. **Create client credentials**

   1. Click `Create credentials`, then copy `Public key` and `Secret key` locally.

      ![Creating client credentials in Tiger Console](/_astro/tiger-cloud-console-client-credentials.DPblOdeh_1iDiNU.webp)

      This is the only time you see the `Secret key`. After this, only the `Public key` is visible in this page.

   2. Click `Done`.

Connect using `psql` or any other PostgreSQL-compatible client or SQL editor, with the connection details below.

Find the connection details in the [PostgreSQL configuration file](https://www.postgresql.org/docs/current/runtime-config-file-locations.html) or by asking your database administrator. The `postgres` superuser, created during PostgreSQL installation, has all the permissions required to run procedures in this documentation. However, it is recommended to create other users and assign permissions on the need-only basis.

Connect using `psql` or any other PostgreSQL-compatible client, with the connection details below.

In the `Services` page of the Managed Service for TimescaleDB Console, click the MST service you want to connect to. You see the connection details:

![MST service connection details](/_astro/mst-connection-info.Doo0G8db_ZgmygI.webp)