Docs
Docs/Get started/Connect a database

Connect to SQLite, PostgreSQL, MySQL, SQL Server or Supabase

Open a SQLite file or connect to a PostgreSQL, MySQL, SQL Server or Supabase database from your Mac, with the fields each connection needs.

A connection tells QuackDB where a database lives and how to reach it. Once saved, it appears under Recent Connections, so reconnecting takes one click.

Add a connection

  1. 01On Recent Connections, choose New database.
  2. 02Pick the database type. Types are grouped as Local (SQLite and Local PostgreSQL) and Remote (PostgreSQL, MySQL, SQL Server and Supabase).
  3. 03For a remote PostgreSQL server, choose Connect Remote. Enter the details from the table below.
  4. 04Choose Test Connection to check the details, then Connect. QuackDB saves the connection and stores the password in the macOS Keychain.
QuackDB New Connection screen listing SQLite and Local PostgreSQL under Local, and PostgreSQL, MySQL, SQL Server and Supabase under Remote
Choose a database type. Local databases need no server details.

Connection details by database

DatabaseWhat you provide
SQLiteChoose the database file on your Mac.
Local PostgreSQLNothing to install. QuackDB starts and manages a PostgreSQL server for you, with no Homebrew or terminal commands.
PostgreSQLConnection name, host, port (5432 by default), username, password and database.
MySQLHost, port, username, password and database.
SQL ServerHost, port, username, password and database.
SupabaseIn the Supabase dashboard open Connect and copy the Direct connection details. Paste the connection string or enter the parameters. QuackDB connects over SSL.
QuackDB Connect to PostgreSQL form with connection name, host, port, username, password and database fields
The PostgreSQL form. Password is optional for servers that do not require one.

Manage saved connections

On Recent Connections, the ⋯ menu lists Export, Import, Edit Connection and Delete Connection under Connections, alongside Settings and Account. Edit a connection to change its name or replace its stored password. Import accepts a SQLite database file or a QuackDB connections export (.json).

Try it first

Demo opens a sample SQLite database so you can explore the editor, grid and schema diagram without connecting anything.

Security

Connection passwords are stored in the macOS Keychain, not in a file. QuackDB connects directly from your Mac to your database. See Security and privacy.

If a connection fails, see Troubleshooting.

Need help?

Join our Discord community for support and discussions.

Join Discord