20MB lightweight database client for 70+ databases
Go to file
t8y2 84018eae89 chore(repo): move deploy files under deploy 2026-05-18 02:20:30 +08:00
.cargo perf: use lld linker for faster Windows builds 2026-05-07 16:21:21 +08:00
.github chore(repo): move deploy files under deploy 2026-05-18 02:20:30 +08:00
.husky chore: add src-web to pre-commit cargo fmt hook 2026-05-05 21:14:24 +08:00
crates/dbx-core fix(sqlserver): load table structure metadata 2026-05-17 20:10:21 +08:00
deploy chore(repo): move deploy files under deploy 2026-05-18 02:20:30 +08:00
docs feat(cli): add dbx node packages 2026-05-18 00:53:06 +08:00
packages chore(packages): release 0.4.3 [skip node-packages-release] 2026-05-17 17:40:02 +00:00
plugins/jdbc fix(jdbc): apply query execution context 2026-05-16 10:49:54 +08:00
public feat(ai): add provider presets 2026-05-17 14:59:18 +08:00
scripts feat(docs): add changelog system, install tabs, and sync workflow 2026-05-16 18:41:12 +08:00
src feat(grid): add custom column formatters 2026-05-17 22:18:08 +08:00
src-tauri chore: bump version to 0.5.11 2026-05-18 02:15:41 +08:00
src-web chore: bump version to 0.5.11 2026-05-18 02:15:41 +08:00
tests fix(ci): restore docs and package checks 2026-05-18 01:04:11 +08:00
.gitignore chore: gitignore releases-*.json and remove from tracking 2026-05-16 18:46:26 +08:00
.nvmrc feat(cli): add dbx node packages 2026-05-18 00:53:06 +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 chore: bump version to 0.5.11 2026-05-18 02:15:41 +08:00
Cargo.toml Revert "feat(cli): add dbx-cli runtime and agent integration (#229)" 2026-05-12 17:31:54 +08:00
LICENSE docs: revamp README with new screenshots and AGPL-3.0 license 2026-05-06 01:40:54 +08:00
README.md chore(repo): move deploy files under deploy 2026-05-18 02:20:30 +08:00
README.zh-CN.md chore(repo): move deploy files under deploy 2026-05-18 02:20:30 +08:00
codecov.yml feat(ci): integrate Codecov for test coverage reporting 2026-05-14 20:33:26 +08:00
components.json feat: initial release 2026-04-29 18:09:23 +08:00
index.html feat: enhance loading experience and update window visibility settings 2026-04-29 18:33:41 +08:00
package.json chore: bump version to 0.5.11 2026-05-18 02:15:41 +08:00
pnpm-lock.yaml feat(cli): add dbx node packages 2026-05-18 00:53:06 +08:00
pnpm-workspace.yaml feat(cli): add dbx node packages 2026-05-18 00:53:06 +08:00
rustfmt.toml chore: add rustfmt.toml and apply unified code formatting 2026-05-05 14:16:18 +08:00
tsconfig.json feat: initial release 2026-04-29 18:09:23 +08:00
vite.config.ts perf: full-stack performance optimization 2026-05-10 23:23:22 +08:00

README.md

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

DBX screenshot

Join Discord Join QQ Group Join WeChat Group

English | 前往中文版本

Features

30+ Databases, One Tool

MySQL, PostgreSQL, SQLite, Redis, MongoDB, DuckDB, ClickHouse, SQL Server, Oracle, Elasticsearch, MariaDB, TiDB, OceanBase, openGauss, GaussDB, KingBase, Vastbase, GoldenDB, Doris, SelectDB, StarRocks, Redshift, DM, TDengine, CockroachDB, Access, HighGo, and more. Agent/JDBC-oriented profiles extend DBX to H2, Snowflake, Trino, Hive, DB2, Informix, Neo4j, Cassandra, BigQuery, Kylin, SunDB, and custom JDBC connections. All in a single ~15 MB app. No bundled Chromium.

Query Editor

CodeMirror 6 with SQL syntax highlighting, metadata-aware autocomplete, Cmd+Enter execution, selected SQL execution, SQL formatting, diagnostics, and 9 editor themes. Persistent query history, saved SQL snippets, tab restore, and SQL file execution keep repeat work close at hand.

AI SQL Assistant

Describe what you want in plain language — get SQL back. DBX can explain queries, optimize SQL, fix errors, and run AI-generated SQL through built-in safety checks. Works with Claude, OpenAI, local models, or any OpenAI-compatible endpoint.

Data Grid

Virtual-scrolled table that handles large result sets. Inline editing, SQL preview before save, WHERE / ORDER BY controls, DataGrip-style filters, LIKE / NOT LIKE context filters, sorting, full-text search, pagination, column resize, auto-fit, row numbers, zebra stripes, and full cell details. Export or copy as CSV, JSON, Markdown, XLSX, or INSERT statements.

Schema Tools

  • Schema browser — databases, schemas, tables, columns, indexes, foreign keys, triggers, with sidebar search & pin
  • Object browser — grouped procedures, functions, views, and source editing where supported
  • Table structure editor — reviewable column and index changes for supported engines
  • ER diagram — visualize table relationships
  • Schema diff — compare structures across connections
  • Explain plan — visual query execution plan
  • Field lineage — column-level lineage analysis
  • Database search — find objects across large schemas

Data Operations

  • Table import — CSV, Excel
  • Data transfer — migrate between databases
  • Database export — full database dump
  • Data compare — compare table data and review synchronization output
  • SQL file execution — run .sql files directly
  • File preview — drag & drop Parquet, CSV, JSON to preview instantly (powered by DuckDB)
  • Connection import — bring connection profiles from DBeaver or Navicat

Specialized Browsers

  • Redis — key pattern search, batch key operations, command runner, TTL editing, and 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) · database and AI proxy settings · auto-reconnect on connection loss · confirmation dialogs for destructive operations · encrypted config export/import · color-coded connections · driver store and optional JDBC plugin

Polished UI

Dark mode with native title bar sync · 9 editor themes · English, 简体中文 & Español · layout preferences · 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.

DBX also provides a dedicated CLI package for terminal, script, and Codex workflows:

npm install -g @dbx-app/cli
dbx connections list --json
dbx query local "select 1" --json

See the MCP server README and CLI 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. A ready-to-use example lives at deploy/docker-compose.yml:

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:

No additional dependencies required.

Linux (Ubuntu/Debian):

sudo apt-get install -y libwebkit2gtk-4.1-dev libgtk-3-dev libappindicator3-dev librsvg2-dev patchelf libssl-dev

Windows:

No additional dependencies required.

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 WeChat Group LINUX DO

Contributors

Star History

Star History Chart

License

AGPL-3.0