bytebase /bytebase
Database governance built for humans and agents — controlling changes and access across every major database.
★ 14,717⑂ 1,013👁 90⑃ 21,435● 557▤ 137
+2
Daily
+43
Weekly
+163
Monthly
14,717
stars
1,013
forks
90
watchers
21,435
prs
557
issues
137
releases
README
⚙️ Install • 📚 Docs • 🙋♀️ Book Demo !banner What is Bytebase? Bytebase is the open-source database governance platform. It acts as a single control plane between your users — humans and AI agents — and your databases, governing change management, access control, and compliance so every change and query is reviewed, controlled, and recorded. !middleware It replaces the disparate tools stitched across migration scripts, SQL clients, and ticketing systems, unifying database operations in a single platform. Supported Databases and Integrations Bytebase supports PostgreSQL, MySQL, SQL Server, Oracle, MongoDB, Redis, MariaDB, TiDB, Snowflake, ClickHouse, Spanner, OceanBase, and more — plus integrations spanning IaC, AI, identity providers, collaboration, ITSM, log streaming, and secret managers. !integrations Key Features Change Management - GUI-Based Workflow: Request, review, deploy, and rollback changes through a web console - GitOps Integration: Native GitHub/GitLab integration for database-as-code workflows - SQL Review: 200+ lint rules to enforce SQL standards and best practices Access Control - Fine-Grained RBAC: Project and workspace-level roles and permissions - Just-in-Time Access: Time-boxed database access grants with automatic revocation - Dynamic Data Masking: Column-level masking applied based on user role at query time Compliance - Audit Logging: Complete audit trail of all database activities - Codified Policy: Manage policies as code via Terraform Provider and API - Data Classification: Identify and tag sensitive data across your databases AI - MCP Server: Connect AI agents and IDEs to Bytebase through the Model Context Protocol - Text-to-SQL: Generate and refine queries in the SQL Editor with AI assistance - Page Agent: Built-in AI assistant that guides or executes workflows from plain language requests Quick Start Docker bash docker run --init \ --name bytebase \ --publish 8080:8080 \ --volume ~/.bytebase/data:/var/opt/bytebase \ bytebase/bytebase:latest Kubernetes bash helm install bytebase bytebase/bytebase Visit http://localhost:8080 and follow the setup wizard. Documentation - Installation Guide - Tutorials - Terraform Provider - API Reference Use Cases For Development Teams - Implement database schema version control - Automate database deployments through CI/CD pipelines - Collaborate on database changes with review workflows For DBAs - Centralize database management across all environments - Enforce organization-wide SQL standards and policies - Monitor and audit all database activities For Security Teams - Control data access with column-level permissions - Implement data masking for sensitive information - Maintain compliance with audit trails Community & Support - Twitter - Issue Tracker - FAQ Contributing We welcome contributions! bash Setup a postgres database with user bbdev and database bbdev export PG_URL=postgresql://bbdev@localhost/bbdev
Top issues
#12130I encountered a bug with an internal error occurred7 comments · 2024-05-27#11535Failed to compute diff between source and target schemas, error: failed to parse and preprocess old statements 7 comments · 2024-04-05#11320helm chart version control7 comments · 2024-03-25#10566Support new databases: Cassandra7 comments · 2024-01-29#9878Unable to login to homepage after auth authentication is successful7 comments · 2023-12-15#13657Impossible to use large sql file to update / initialise schema5 comments · 2024-09-04#7882Postgres should filter out internal objects from timescaledb extension5 comments · 2023-08-31#7196Gitea support as VCS integration5 comments · 2023-07-24
Latest release
Release 3.24.1 3.24.1 2026-11-05🐞 Bug Fixes - PostgreSQL/MySQL — Fix memory growth on instances connected with Google Cloud SQL IAM authentication. - PostgreSQL — Fix connections left open on the database when tenant mode is enabled in the project. 🏗️ Upgrade Notes - Terraform: Terraform provider 3.24.0 requires Bytebase 3.24.0 or later. It can now manage allow_last_plan_editor_approval on projects, inactive_session_timeout_in_seconds in the workspace profile, the workspace MCP capability, AI provider settings, and standard review-rule policies. Before you apply: a settings/APP_IM write now takes effect and remo