> ## Documentation Index
> Fetch the complete documentation index at: https://www.integrate.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# ETL: Connecting to Heroku Postgres

> Connect Heroku Postgres to Integrate.io ETL for reading and writing data. Configure database credentials, SSL, and connection settings.

* Create a user and grant it minimum permissions required for Integrate.io ETL to read or write data from the database.
* Allow access from [Integrate.io ETL's IP addresses](/etl/integrateio-etls-ip-list/) to your Heroku Postgres database port (Refer to [this](/etl/allowing-integrateio-etl-access-to-my-server-behind-a-firewall/) article if you'd prefer to create an SSH tunnel or reverse SSH tunnel.)

<Frame>
  <iframe className="w-full aspect-video rounded-xl" src="https://fast.wistia.com/embed/iframe/1d9hcs888q" title="Allowing Integrate.io ETL access to Heroku Postgres Databases" allow="autoplay; fullscreen" allowFullScreen />
</Frame>

## To create a Heroku Postgres database connection in Integrate.io ETL

<Steps>
  <Step>
    Click the Connections icon (lightning bolt) on the top left menu.
  </Step>

  <Step>
    To create a connection, click **New connection**.

    <Frame>
      <img src="https://mintcdn.com/integrateio/V1Ns1A4dfxUcZVN3/images/connectivity-and-security/image-22.webp?fit=max&auto=format&n=V1Ns1A4dfxUcZVN3&q=85&s=3d6192c599466c28c1bd87152f650ed8" alt="New connection button in the Connections page" width="1200" height="840" data-path="images/connectivity-and-security/image-22.webp" />
    </Frame>
  </Step>

  <Step>
    Select Heroku Postgres and name the connection.
  </Step>

  <Step>
    Select your access type (direct connection if you've whitelisted Integrate.io ETL's IP addresses.)
  </Step>

  <Step>
    Enter your Heroku Postgres database host name or IP address.
  </Step>

  <Step>
    Enter the database name.
  </Step>

  <Step>
    Enter the username.
  </Step>

  <Step>
    Enter the user's password.
  </Step>

  <Step>
    Click **Test Connection** to make sure the connection details are correct.
  </Step>

  <Step>
    Click **Create connection** to create the connection.

    <Frame>
      <img src="https://mintcdn.com/integrateio/V1Ns1A4dfxUcZVN3/images/connectivity-and-security/image-23.webp?fit=max&auto=format&n=V1Ns1A4dfxUcZVN3&q=85&s=737e13f26a7f80b09e9f7274d7833e57" alt="Heroku Postgres connection configuration form with host, database, and credentials" width="1200" height="827" data-path="images/connectivity-and-security/image-23.webp" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/integrateio/V1Ns1A4dfxUcZVN3/images/connectivity-and-security/image-24.webp?fit=max&auto=format&n=V1Ns1A4dfxUcZVN3&q=85&s=e343f5cdcc60fd3a6a1a8b86536cf68f" alt="Successful Heroku Postgres connection test confirmation" width="1200" height="827" data-path="images/connectivity-and-security/image-24.webp" />
    </Frame>
  </Step>
</Steps>