Files
supabase/apps/docs/content/guides/database/dbeaver.mdx
T
a0eff938ff New connection management docs (#29166)
* recreated connecting-to-postgres

* adding GUI quickstart section with DBeaver

* moved psql and pgadmin docs to GUI quickstart

* added Prisma installation docs. Moved postgres.js and Drizzle into own section

* added connection management docs

* moved supavisor troubleshooting guide into troubleshooting section. Probably should not merge without adding more guides

* updated IPv4 Add ons docs

* removed typo

* Update apps/docs/content/guides/platform/ipv4-address.mdx

Co-authored-by: Charis <26616127+charislam@users.noreply.github.com>

* Update apps/docs/content/guides/platform/ipv4-address.mdx

Co-authored-by: Charis <26616127+charislam@users.noreply.github.com>

* Update apps/docs/content/guides/database/supavisor.mdx

Co-authored-by: Charis <26616127+charislam@users.noreply.github.com>

* Update apps/docs/content/guides/database/prisma.mdx

Co-authored-by: Charis <26616127+charislam@users.noreply.github.com>

* Update apps/docs/content/guides/database/connection-management.mdx

Co-authored-by: Charis <26616127+charislam@users.noreply.github.com>

* Update apps/docs/content/guides/database/connection-management.mdx

Co-authored-by: Charis <26616127+charislam@users.noreply.github.com>

* Update apps/docs/components/Navigation/NavigationMenu/NavigationMenu.constants.ts

Co-authored-by: Charis <26616127+charislam@users.noreply.github.com>

* removed repetition in connection-management | added photos

* Update apps/docs/content/guides/database/connecting-to-postgres.mdx

Co-authored-by: Stas <sts@abc3.dev>

* Update apps/docs/content/guides/platform/ipv4-address.mdx

Co-authored-by: Stas <sts@abc3.dev>

* Update apps/docs/content/guides/database/connection-management.mdx

Co-authored-by: Stas <sts@abc3.dev>

* Update apps/docs/content/guides/database/connecting-to-postgres.mdx

Co-authored-by: Stas <sts@abc3.dev>

* Update apps/docs/content/guides/platform/ipv4-address.mdx

Co-authored-by: Charis <26616127+charislam@users.noreply.github.com>

* Update apps/docs/content/guides/database/connecting-to-postgres.mdx

Co-authored-by: Stas <sts@abc3.dev>

* updated proxy suggestions

* added redirects

* added images to connection-management guide

* added unique ids to titles in prisma-troubleshooting section

* added images to connection guide

* added new images to prisma guide

* reformatted admonition

---------

Co-authored-by: Brian Brennglass <brian@Brians-MacBook-Pro.local>
Co-authored-by: Charis <26616127+charislam@users.noreply.github.com>
Co-authored-by: Stas <sts@abc3.dev>
2024-10-03 19:42:49 +00:00

97 lines
3.3 KiB
Plaintext

---
id: 'dbeaver'
title: 'Connecting with DBeaver'
breadcrumb: 'GUI Quickstarts'
hideToc: true
---
If you do not have DBeaver, you can download it from its [website](https://dbeaver.io/download/).
<StepHikeCompact>
<StepHikeCompact.Step step={1}>
<StepHikeCompact.Details title="Create a new database connection">
Create a new database connection
</StepHikeCompact.Details>
<StepHikeCompact.Code>
![new database connection](/docs/img/guides/database/connecting-to-postgres/dbeaver/new_database_connection.png)
</StepHikeCompact.Code>
</StepHikeCompact.Step>
<StepHikeCompact.Step step={2}>
<StepHikeCompact.Details title="Select PostgreSQL" />
<StepHikeCompact.Code>
![Selection Menu](/docs/img/guides/database/connecting-to-postgres/dbeaver/select_postgres.png)
</StepHikeCompact.Code>
</StepHikeCompact.Step>
<StepHikeCompact.Step step={3}>
<StepHikeCompact.Details title="Get Your Credentials">
Inside the Dashboard's [Database Settings](https://supabase.com/dashboard/project/_/settings/database), note your session mode's:
- host
- username
You will also need your database's password. If you forgot it, you can generate a new one in the settings.
<Admonition type="note">
If you're in an [IPv6 environment](https://github.com/orgs/supabase/discussions/27034) or have the IPv4 Add-On, you can use the direct connection string instead of Supavisor in Session mode.
</Admonition>
</StepHikeCompact.Details>
<StepHikeCompact.Code>
![database credentials](/docs/img/guides/database/connecting-to-postgres/dbeaver/session_mode.png)
</StepHikeCompact.Code>
</StepHikeCompact.Step>
<StepHikeCompact.Step step={4}>
<StepHikeCompact.Details title="Fill out credentials">
In DBeaver's Main menu, add your host, username, and password
</StepHikeCompact.Details>
<StepHikeCompact.Code>
![filling out form](/docs/img/guides/database/connecting-to-postgres/dbeaver/filling_credentials.png)
</StepHikeCompact.Code>
</StepHikeCompact.Step>
<StepHikeCompact.Step step={5}>
<StepHikeCompact.Details title="Download certificate">
In the [Database Settings](https://supabase.com/dashboard/project/_/settings/database), download your SSL certificate.
</StepHikeCompact.Details>
<StepHikeCompact.Code>
![filling out form](/docs/img/guides/database/connecting-to-postgres/dbeaver/certificate.png)
</StepHikeCompact.Code>
</StepHikeCompact.Step>
<StepHikeCompact.Step step={6}>
<StepHikeCompact.Details title="Secure your connection">
In DBeaver's SSL tab, add your SSL certificate
</StepHikeCompact.Details>
<StepHikeCompact.Code>
![filling out form](/docs/img/guides/database/connecting-to-postgres/dbeaver/ssl_tab.png)
</StepHikeCompact.Code>
</StepHikeCompact.Step>
<StepHikeCompact.Step step={7}>
<StepHikeCompact.Details title="Connect">
Test your connection and then click finish. You should now be able to interact with your database with DBeaver
</StepHikeCompact.Details>
<StepHikeCompact.Code>
![connected dashboard](/docs/img/guides/database/connecting-to-postgres/dbeaver/finished.png)
</StepHikeCompact.Code>
</StepHikeCompact.Step>
</StepHikeCompact>