# ChartDB

ChartDB is an open-source database diagram editor. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/265/chartdb

## Description

ChartDB is an open-source database diagram editor. It visualizes and designs database schemas from a single query, making structure review and documentation easier for developers, database administrators, and self-hosters. Run it alongside your database to inspect existing structures, plan changes, or share clear diagrams from your own infrastructure.

## Platform availability

Available on 1 of 9 platforms: Unraid.

## Health score

62/100 (Good), based on 5 of 5 factors.
- Maintained: 53 (last commit 196 days ago)
- Popular: 87 (22,987 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Light to run: 70 (1 GB minimum RAM)
- Security check: 70 (no serious findings, 11 minor, CI, tests)

## Links

- Documentation: https://docs.chartdb.io/
- GitHub: https://github.com/chartdb/chartdb
- Unraid: https://ca.unraid.net/apps/chartdb-1yii7ga0amfe4u?q=ChartDB
- Official website: https://chartdb.io/

## Common questions

### Which Docker port should I expose for self-hosted ChartDB?

Map the container port 80 to a host port such as 8080, then use that host port to reach the app.

### Where are diagrams stored in the self-hosted version?

The self-hosted version stores diagrams only in your browser's local storage. They can disappear if that browser data is lost, so manual exports are needed for backup.

### How do I connect ChartDB to a local OpenAI-compatible model for AI features?

Set VITE_OPENAI_API_ENDPOINT to your local vLLM address and VITE_LLM_MODEL_NAME to the model name before starting the app. Without these settings, AI-powered database help may not connect or may use the wrong model.

### Does ChartDB require the database password to create a schema diagram?

No, ChartDB imports the schema with a single query and does not require the database password.

### Can self-hosted ChartDB be deployed with email-domain access control?

A deployment guide describes deploying ChartDB on Cloudflare Pages with access restricted to an organization email domain.

## Alternatives

- DBDiagram.io: Quick and simple free tool to help you draw your database relationship diagrams and flow quickly using simple DSL language.
- Mermaid: Ever wanted to simplify documentation and avoid heavy tools like Visio when explaining your code?
- MySQL Workbench: MySQL Workbench is a unified visual tool for database architects, developers, and database administrators to design, develop, and manage My…
- Visual Paradigm: Visual Paradigm for UML (VP-UML) is a UML design tool and UML CASE tool designed to aid software development.

---
Source: Our Local Host (https://ourlocalhost.com/app/265/chartdb), the self-hosted and open-source app directory.