PG Orbit · Guides
Connect to Supabase
Supabase is Postgres, so PG Orbit talks to it natively. The fastest path is one-tap cloud discovery — sign in with Supabase and import your projects. Manual setup takes about a minute.
Get your credentials
In the Supabase dashboard, open your project → Connect (top bar). Use the Direct connection or Session pooler parameters: host, port, database (postgres), user, and your database password (set in Project Settings → Database if you've forgotten it).
Add the connection in PG Orbit
- Easiest: Connections → cloud icon → Supabase → sign in → import your project
- Manual: tap + to add a connection
- Host: db.<project-ref>.supabase.co (direct) or the pooler host from the Connect panel
- Port: 5432 (direct/session pooler) — Database: postgres — Username: postgres (or postgres.<project-ref> for the pooler)
- Turn ON Use SSL, tap Test, save
Good to know
- IPv4 networks sometimes can't reach the direct host on free-tier projects — use the session pooler host if the direct connection times out.
- The transaction pooler (port 6543) is for short-lived app connections; for interactive work prefer direct or session pooler.