Getting Started

Welcome to GluonDB! This guide will walk you through setting up your first project and making your first query in just a few minutes.

What You'll Need

  • A GluonDB account (sign up at gluondb.com)
  • A PostgreSQL database connection string (DSN)

Step 1: Create Your Project

After signing in, click New Project from your dashboard. Give your project a descriptive name — this helps you organize multiple databases later.

getting_started/1.png


Step 2: Connect Your Database

Enter your PostgreSQL connection string (DSN) to link your database. GluonDB will securely connect and begin indexing your schema.

getting_started/2.png

> Security Tip: We recommend creating a dedicated read-only user for GluonDB. See our Secure DSN strings guide for step-by-step instructions.


Step 3: Make Your First Query

Once connected, you can start querying immediately. Use the SQL editor to write queries directly, or let the Agent help you explore your data.

getting_started/3.png


Step 4: Chat with the Agent

The GluonDB Agent understands natural language. Ask questions like:

  • *"Show me the top 10 customers by revenue"*
  • *"Create a chart of monthly signups"*
  • *"Build a dashboard for sales performance"*
The Agent will write SQL, generate visualizations, and even create full dashboards — all from your conversation.

getting_started/4.png


Next Steps

Now that you're set up, explore what GluonDB can do:


Need help? Reach out to us on support@gluonDB.com.