Quickstart
Run OpenDash on your machine with a sample company, ask your first question, and open the trace behind the answer.
This gets OpenDash running locally with sample data in about ten minutes. To deploy it for a team, follow Self-host instead.
You need: Node.js 24, pnpm (through corepack), Docker, and a model provider key (Anthropic, OpenAI, Google or a Vercel AI Gateway key).
Clone and install
git clone https://github.com/getopendash/opendash.git && cd opendash
corepack enable && pnpm installConfigure
cp .env.example .env.localIn .env.local, set two secrets (run openssl rand -base64 32 for each) and one model key:
BETTER_AUTH_SECRET=...
OPENDASH_KEK=...
ANTHROPIC_API_KEY=... # or OPENAI_API_KEY, GOOGLE_GENERATIVE_AI_API_KEY, AI_GATEWAY_API_KEYStart everything
pnpm dxThis checks your setup, starts Postgres in Docker, creates the database roles, runs migrations, and starts the web app and the worker.
Seed a sample company
In a second terminal:
pnpm demo:seedThis creates Acme, a SaaS company with accounts, subscriptions, invoices and support tickets, in its own database with a read-only user. The command prints the connection details.
Sign up and connect
Open localhost:3000/sign-up and sign up. Without an email provider, the sign-in link is printed in the web server's log. Create a workspace, then go to Data → Connect source and enter the details demo:seed printed. The connection check recognises it and marks it Sample data.
Approve the starter pack it proposes: a set of metrics and glossary terms for the sample company.
Ask a question
Open Ask (or press N anywhere) and try:
- What was MRR last month, by plan?
- How many customers churned last quarter, and why?
- Which urgent tickets are still open?
Build a dashboard
Open Dashboards and pick Revenue review. The analyst opens beside the page with the request begun: finish it and send it. It replies with a plan; press Build it and watch the dashboard build. See Dashboards.
Read the answer
Every number in the answer is a link. Open one to see the query it came from and the rows behind it. The label on the answer tells you which path it took:
- Metric: built from definitions an admin approved.
- Unmodelled: SQL written over the tables, cross-checked, and labelled so you know.
Open the Sources panel for the interpretation, the context the analyst used, every query, and the checks the answer gate ran. Ask and trace explains each part.
Next steps
Connect your own database
Teach it your business
Set up a routine
Deploy it
No database at hand?
Under Data → Connect source, choose Use the playground to connect ClickHouse's public playground (house prices, GitHub events, taxi trips and more). It needs internet access.
Overview
OpenDash is the open-source AI analyst for startup operators. Connect a read-only database, ask in plain language, and get answers where every number traces back to a query you can open.
Core concepts
The few ideas the rest of the docs build on, from workspaces and sources to the answer gate and the learning loop.