> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify-poc.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Find your connection details

> Connect to Tiger Cloud, self-hosted TimescaleDB, or MST using your connection details

export const SERVICE_SHORT = 'service';

export const SERVICE_LONG = 'Tiger Cloud service';

export const SELF_LONG_CAP = 'Self-hosted TimescaleDB';

export const SELF_LONG = 'self-hosted TimescaleDB';

export const PROJECT_SHORT = 'project';

export const PROJECT_LONG = 'Tiger Cloud project';

export const PG = 'Postgres';

export const MST_SERVICE_SHORT = 'service';

export const MST_LONG = 'Managed Service for TimescaleDB';

export const MST_CONSOLE_LONG = 'MST Console';

export const CONSOLE = 'Tiger Console';

export const CLOUD_LONG = 'Tiger Cloud';

To connect to your {SERVICE_LONG}, {SELF_LONG}, or {MST_LONG}, you need at least the following:

* Hostname
* Port
* Username
* Password
* Database name

Find the connection details based on your deployment type:

<Tabs>
  <Tab title={CLOUD_LONG}>
    ## Connect to your service

    Retrieve the connection details for your {SERVICE_LONG}:

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

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

    * **In {CONSOLE}**:

      Open the [`Services`][services-portal] page and select your {SERVICE_SHORT}. 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\_LONG connection details][service-connection-details]

    ## Find your project and service ID

    To retrieve the connection details for your {PROJECT_LONG} and {SERVICE_LONG}:

    1. **Retrieve your {PROJECT_SHORT} ID**:

       In [{CONSOLE}][services-portal], click the arrows next to the {PROJECT_SHORT} name in the top left. The {PROJECT_SHORT} ID is under the {PROJECT_SHORT} name.

       ![Retrieve the project ID in CONSOLE][retrieve-project-id]

    2. **Retrieve your {SERVICE_SHORT} ID**:

       Click the dots next to the {SERVICE_SHORT}, then click `Copy` next to the {SERVICE_SHORT} ID.

       ![Retrieve the service ID in CONSOLE][retrieve-service-id]

    ## Create client credentials

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

    To retrieve the connection details for your {CLOUD_LONG} {PROJECT_SHORT} for programmatic usage
    such as Terraform or the [{CLOUD_LONG} REST API][rest-api-reference]:

    1. **Open the settings for your {PROJECT_SHORT}**:

       In [{CONSOLE}][services-portal], click `Settings`.

    2. **Create client credentials**:

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

          ![Create client credentials in CONSOLE][create-client-credentials]

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

       2. Click `Done`.
  </Tab>

  <Tab title={SELF_LONG_CAP}>
    Find the connection details in the [{PG} configuration file][postgres-config] or by asking your database administrator. The `postgres` superuser, created during {PG} 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.
  </Tab>

  <Tab title={MST_LONG}>
    In the `Services` page of the {MST_CONSOLE_LONG}, click the {MST_SERVICE_SHORT} you want to connect to. You see the connection details:

    ![MST connection details][mst-connection-details]
  </Tab>
</Tabs>

[create-client-credentials]: https://assets.timescale.com/docs/images/tiger-cloud-console/tiger-cloud-console-client-credentials.png

[mst-connection-details]: https://assets.timescale.com/docs/images/mst-connection-info.png

[postgres-config]: https://www.postgresql.org/docs/current/runtime-config-file-locations.html

[rest-api-reference]: /api/:currentVersion:/api-reference/

[retrieve-project-id]: https://assets.timescale.com/docs/images/tiger-on-azure/tiger-console-project-id.png

[retrieve-service-id]: https://assets.timescale.com/docs/images/tiger-on-azure/tiger-console-service-id.png

[service-connection-details]: https://assets.timescale.com/docs/images/tiger-cloud-console/tiger-service-connection-details.png

[services-portal]: https://console.cloud.timescale.com/dashboard/services