Skip to main content
ChartDB never stores or accesses your data - the import query only retrieves schema metadata.

Quick Start

1

Create New Diagram

  1. Click File > New in the ChartDB editor
  2. Select PostgreSQL from the database options
2

Choose Database Edition

Select your PostgreSQL edition:
  • Regular - Standard PostgreSQL installations
  • Supabase - Supabase-hosted PostgreSQL databases
  • Timescale - TimescaleDB installations
3

Run Import Query

Execute the provided query using either:
  • Your database client (e.g., pgAdmin, DBeaver)
  • Direct psql connection
  • Supabase SQL Editor (for Supabase databases)
4

Import Results

  1. Copy the JSON output from the query
  2. Paste into ChartDB’s import field
  3. Click Import to generate your diagram

Import Methods

Execute the appropriate query based on your PostgreSQL edition:
Execute the appropriate query based on your PostgreSQL edition:
  1. Navigate to the Supabase SQL Editor
  2. Create a new query
  3. Paste and run the Supabase query from the Database Client tab
  4. Click “Copy cell content” on the results
Connect and run the appropriate query via psql based on your PostgreSQL edition. Replace the following in the command:
  • hostname: Your database host (e.g., localhost)
  • port: Database port (default: 5432)
  • username: Database user
  • database_name: Name of your database
PostgreSQL connection strings typically follow this format:
The pbcopy command for copying query results is only available on macOS. For other operating systems, please use your system’s clipboard command or copy the output manually.

Troubleshooting

Common Issues Guide

Find solutions for frequently encountered import problems and their resolutions