README.md
May 7, 2026 · View on GitHub
DBX
25+ databases in 15 MB. Desktop & Docker self-hosting, with built-in AI assistant.
English | 前往中文版本
Features
17+ Databases, One Tool
MySQL, PostgreSQL, SQLite, Redis, MongoDB, DuckDB, ClickHouse, SQL Server, Oracle, Elasticsearch, MariaDB, TiDB, OceanBase, openGauss, GaussDB, KingBase, Vastbase, GoldenDB — connect to all of them from a single ~15 MB app. No bundled Chromium.
Query Editor
CodeMirror 6 with SQL syntax highlighting, smart autocomplete (tables & columns), Cmd+Enter execution, selected SQL execution, SQL formatting, and 9 editor themes. Persistent query history with search and restore.
AI SQL Assistant
Describe what you want in plain language — get SQL back. Also explains, optimizes, and fixes errors. Works with Claude, OpenAI, or any OpenAI-compatible endpoint.
Data Grid
Virtual-scrolled table that handles millions of rows. Inline editing, sorting, full-text search, pagination, column resize, row numbers, zebra stripes. Export to CSV, JSON, Markdown.
Schema Tools
- Schema browser — databases, schemas, tables, columns, indexes, foreign keys, triggers, with sidebar search & pin
- ER diagram — visualize table relationships
- Schema diff — compare structures across connections
- Explain plan — visual query execution plan
- Field lineage — column-level lineage analysis
Data Operations
- Table import — CSV, Excel
- Data transfer — migrate between databases
- Database export — full database dump
- SQL file execution — run
.sqlfiles directly - File preview — drag & drop Parquet, CSV, JSON to preview instantly (powered by DuckDB)
Specialized Browsers
- Redis — key pattern search, all data types (String, Hash, List, Set, ZSet, Stream)
- MongoDB — document CRUD with pagination, Atlas & replica set URL connection
Safety & Connectivity
SSH tunnel (key & password) · auto-reconnect on connection loss · confirmation dialogs for destructive operations · encrypted config export/import · color-coded connections
Polished UI
Dark mode with native title bar sync · 9 editor themes · English & 简体中文 · built-in auto-update
AI Agent Integration (MCP)
DBX provides an MCP server that lets AI coding agents query your databases using connections already configured in DBX.
npx @dbx-app/mcp-server
Add to your .mcp.json:
{
"mcpServers": {
"dbx": { "command": "npx", "args": ["-y", "@dbx-app/mcp-server"] }
}
}
Works with Claude Code, Cursor, Windsurf, and any MCP-compatible agent. Supports listing connections, browsing tables, executing SQL, and opening tables directly in DBX's UI.
See the MCP server README for details.
Install
Download the latest release from the Releases page.
Homebrew (macOS):
brew install --cask t8y2/tap/dbx
Scoop (Windows):
scoop bucket add dbx https://github.com/t8y2/scoop-bucket
scoop install dbx
Self-Hosted (Docker)
DBX provides a web version that can be deployed via Docker.
docker run -d --name dbx -p 4224:4224 -v dbx-data:/app/data t8y2/dbx
Or with Docker Compose:
services:
dbx:
image: t8y2/dbx
ports:
- "4224:4224"
volumes:
- dbx-data:/app/data
restart: unless-stopped
volumes:
dbx-data:
Open http://localhost:4224 in your browser. Multi-arch images (amd64 / arm64) are available.
Getting Started
Prerequisites
System Dependencies
macOS:
brew install unixodbc
Linux (Ubuntu/Debian):
sudo apt-get install -y libwebkit2gtk-4.1-dev libgtk-3-dev libappindicator3-dev librsvg2-dev patchelf libssl-dev unixodbc-dev
Windows:
No additional dependencies required (ODBC is built into Windows).
Development
pnpm install
pnpm dev:tauri
Web version:
pnpm dev:web # frontend
pnpm dev:backend # backend
Build
pnpm tauri build
The installer will be in src-tauri/target/release/bundle/.
Tech Stack
| Layer | Technology |
|---|---|
| Framework | Tauri 2 |
| Frontend | Vue 3 + TypeScript |
| UI | shadcn-vue + Tailwind CSS |
| Editor | CodeMirror 6 |
| Backend | Rust + sqlx / tiberius / redis-rs / mongodb |



