dbportal keyhole iris logo
0%
Charging Keyhole Iris...
npm v1.1.0
GSSoC 2026 Featured

Single-Command Database Explorer & Docker Manager

Stop wrestling with heavy desktop clients. Inspect PostgreSQL, Mongo, MySQL, SQLite, Redis & Docker containers directly in your browser — zero config, 100% local, read-only safe.

Quick Launcher

Run locally in any project directory

$npx dbportal
Auto .env Fleet
PG, Mongo, MySQL, Redis
Read-Only Safe
Zero mutation risk
100% Localhost
Bound to 127.0.0.1:4444
Loading Sandbox Simulator...

Supported Connection Protocols

Place your database connection strings in your .env file — dbportal auto-detects drivers seamlessly.

PostgreSQL & CockroachDBNative Pool
Protocols: postgresql:// / postgres://
postgresql://postgres:secret@localhost:5432/production_db
MongoDB DriverBSON Engine
Protocols: mongodb:// / mongodb+srv://
mongodb://root:pass@127.0.0.1:27017/analytics_db
MySQL & MariaDBBinary Stream
Protocols: mysql:// / mysql2://
mysql://admin:password@localhost:3306/ecommerce_db
SQLite 3 (Embedded)Zero Server
Protocols: sqlite: / sqlite3:
sqlite://./data/application.sqlite3
Redis K-V StoreIn-Memory
Protocols: redis:// / rediss://
redis://:session_secret@127.0.0.1:6379/0
Microsoft SQL ServerT-SQL Pool
Protocols: mssql:// / sqlserver://
mssql://sa:StrongPass123@localhost:1433/enterprise_db

Engineered for Developer Velocity & Safety

No cloud telemetry, no account registration, no heavy Electron VM bloat. Pure local speed.

Multi-Driver Database Fleet

Native driver support for PostgreSQL, CockroachDB, MongoDB, MySQL, MariaDB, SQLite, SQL Server & Redis. No generic query parser wrapper — pure native performance.

PostgreSQLMongoDBMySQLSQLiteRedisCockroachDBSQL Server

Instant Docker Daemon GUI

Bridges directly to your local Docker socket via dockerode. Monitor live metrics, launch images, and manage volumes.

$ dbportal --docker

Read-Only Safety

Prevents accidental database mutations, table drops, or rogue UPDATE queries during local inspection and debugging sessions.

100% Safe Connection Layer

Relational ER Schema Visualizer

Auto-inspects foreign key constraints and schema metadata to dynamically render interactive entity-relationship maps. Drag, zoom, and inspect fields instantly.

🔗 users_tablePK
id: uuid
email: varchar
orders_count: integer

Multi-Connection Dashboard

Specify DATABASE_URL_1 through DATABASE_URL_10 in your .env file for unified fleet inspection.

DATABASE_URL_1=postgres://...
DATABASE_URL_2=mongodb://...

docker-compose.yml Exporter

Configure container environment variables, ports, and volume mounts visually, then export clean, valid docker-compose.yml files for fast local scaffolding.

services:
dbportal:
image: postgres:alpine
ports: - "5432:5432"
Loading Docker Compose Exporter...
Loading CLI Generator...

Security & Local Architecture

Built with an unyielding local-first security stance. Inspect databases without compromising sensitive local or production data.

Localhost Binding Only (127.0.0.1)

dbportal binds strictly to your loopback address 127.0.0.1:4444. It is never exposed over public networks, external interfaces, or remote IP addresses.

Local bound socket active: 127.0.0.1:4444

Enforced Read-Only Engine

All database connections operate under strict read-only parameters. Destructive transactions like UPDATE, DELETE, and DROP are blocked at driver level.

Zero Cloud Telemetry

Zero analytics tracking, zero third-party cloud pings, zero tracking scripts. Operates fully air-gapped without active internet connections.

Docker Socket Isolation

Communicates directly with your local Docker daemon socket (/var/run/docker.sock or //./pipe/docker_engine) using native dockerode bindings.

Zero Credential Storage

Your database connection credentials remain isolated inside your local .env file. No tokens or keys are saved externally.

Open Source MIT License Integrity

Fully transparent codebase published on GitHub and npmjs. Audit the source code, verify dependencies, and contribute directly to GSSoC 2026.

GitHub RepositoryLicense: MIT

Architectural Benchmarks

Comparison between dbportal single-command CLI and traditional desktop tools.

FeaturedbportalDBeaverDocker DesktoppgAdmin
Setup Overhead0 Seconds (npx)5-10 Mins (Installer)5-15 Mins (Heavy GUI)10 Mins (Config)
RAM Footprint~45 MB (Node API)~650 MB (Java JVM)~1.2 GB+ (VM Electron)~400 MB (Python/Web)
Multi-Database Fleet✔ Yes (Auto .env)Manual Setup❌ No (Containers only)❌ Postgres only
Docker Container GUI✔ Yes (--docker)❌ No✔ Yes❌ No
Read-Only Safety Guarantee✔ Yes (Enforced)Manual ToggleN/AManual Toggle
Network Isolation127.0.0.1 (Local only)Local DesktopLocal DaemonLocal HTTP

Frequently Asked Questions

Everything you need to know about dbportal architecture, security, and usage.

When executed without flags (npx dbportal), the CLI scans the current working directory for a .env file. It reads DATABASE_URL as well as DATABASE_URL_1 through DATABASE_URL_10, identifies the protocol prefix (e.g. postgres://, mongodb://, sqlite:), and initializes native driver pools.
Open-Source Ecosystem

Community & Contributions

dbportal is an open-source project featured in GirlScript Summer of Code (GSSoC) 2026.

Star on GitHub

Audit the codebase, report issues, and submit pull requests under GSSoC 2026.

GitHub Repository

Join Discord

Collaborate directly with maintainers, ask questions, and discuss features.

Discord Server

Roadmap & npm

Track project milestones and inspect npm registry package distribution.

Maintained with care byManan Gupta& contributors
License: MITVersion: 1.1.0