20MB lightweight database client for 70+ databases
Go to file
Illuminated2020 2fd3e533e9 fix(dbx-cli): 修复空存储下 context 回退
- 在 GUI runtime 不可用且 headless storage 无法打开时返回空上下文

- 增加空 app data 与不可打开 app data 的 dbx-cli 回归测试
2026-05-12 16:52:35 +08:00
.cargo perf: use lld linker for faster Windows builds 2026-05-07 16:21:21 +08:00
.github fix(updater): show real app version and release notes 2026-05-12 15:15:46 +08:00
.husky chore: add src-web to pre-commit cargo fmt hook 2026-05-05 21:14:24 +08:00
1panel refactor(ci): switch 1Panel appstore to community repo and manual trigger 2026-05-11 11:41:51 +08:00
crates fix(dbx-cli): 修复空存储下 context 回退 2026-05-12 16:52:35 +08:00
docs build(dbx-cli): 将 CLI 二进制改名为 dbx-cli 2026-05-12 16:43:46 +08:00
mcp feat(proxy): 增加数据库和 AI 代理支持 2026-05-11 15:05:25 +08:00
plugins/jdbc feat(jdbc): add optional JDBC plugin support 2026-05-10 12:57:38 +08:00
public Refactor code structure for improved readability and maintainability 2026-05-05 13:21:04 +08:00
src fix: harden handoff status transitions 2026-05-12 16:52:35 +08:00
src-tauri fix: harden handoff status transitions 2026-05-12 16:52:35 +08:00
src-web chore: bump version to 0.5.4 2026-05-12 14:56:10 +08:00
tests fix: harden handoff status transitions 2026-05-12 16:52:35 +08:00
.dockerignore feat: add web deployment with axum server, Docker support, and browser UI 2026-05-05 03:16:50 +08:00
.gitignore chore: ignore worktree directory 2026-05-12 16:43:46 +08:00
.oxfmtrc.json chore: add oxfmt + husky + lint-staged for code formatting and CI format checks 2026-05-05 15:41:34 +08:00
Cargo.lock fix(agent-runtime): 修复运行时 HTTP 读取与发现文件写入 2026-05-12 16:49:29 +08:00
Cargo.toml feat(cli): 添加 CLI crate 骨架 2026-05-12 16:43:46 +08:00
Dockerfile fix(docker): touch source files to force cargo recompilation 2026-05-07 21:12:41 +08:00
LICENSE docs: revamp README with new screenshots and AGPL-3.0 license 2026-05-06 01:40:54 +08:00
README.md docs: add system dependencies and update GaussDB driver info 2026-05-07 13:18:02 +08:00
README.zh-CN.md docs: add system dependencies and update GaussDB driver info 2026-05-07 13:18:02 +08:00
components.json
docker-compose.yml feat: add web deployment with axum server, Docker support, and browser UI 2026-05-05 03:16:50 +08:00
index.html
package.json chore: bump version to 0.5.4 2026-05-12 14:56:10 +08:00
pnpm-lock.yaml feat: editor enhancements, DataGrid refactor, and sidebar improvements 2026-05-11 01:08:07 +08:00
rustfmt.toml chore: add rustfmt.toml and apply unified code formatting 2026-05-05 14:16:18 +08:00
tsconfig.json
vite.config.ts perf: full-stack performance optimization 2026-05-10 23:23:22 +08:00

README.md

DBX

25+ databases in 15 MB. Desktop & Docker self-hosting, with built-in AI assistant.

Join Discord Join QQ Group

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 .sql files 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

Community

Discord QQ Group LINUX DO

Contributors

Star History

Star History Chart

License

AGPL-3.0