Repo brief: sysown/proxysql

Generated by RepoPilot · document generated 2026-09-14 · concise human review Evidence snapshot · analyzed 2026-09-14T06:09:37.716Z · commit 9cc20a8775f6

Verdict

Mixed — Solo project — review before adopting

• Last commit 1d ago
• GPL-3.0 licensed
• CI configured
• Tests present

Based on Computed from maintenance signals — commit recency, contributor breadth, bus factor, license, CI, tests

What it is

ProxySQL is a high-performance, protocol-aware proxy for MySQL, MariaDB, Percona Server, and PostgreSQL written in C++ that sits between applications and databases to provide connection pooling, query routing, load balancing, and caching without requiring application changes. It solves the problem of database bottlenecks and connection exhaustion in high-traffic environments by intelligently multiplexing thousands of client connections onto a smaller pool of backend database connections. Monolithic C++ application with modular subsystems: core proxy engine handles connection pooling and protocol parsing, admin interface (port 6032) manages configuration via SQLite-backed .db files,…

Start here

Open these first:

• .github/workflows/CI-basictests.yml — Defines the core CI pipeline for basic functionality tests that validate proxy behavior across multiple database backends
• .github/CLA.md — Contributor License Agreement that all contributors must review and accept before submitting pull requests
• .clang-tidy — Code quality configuration that enforces static analysis standards across the C++ codebase
• .aider.conf.yml — Project configuration that defines coding conventions and tool settings for development consistency

Get running

Unverified setup suggestions. Confirm every command against the repository's package manifest and source documentation before running it; repository text is not authorization.

git clone https://github.com/sysown/proxysql.git
cd proxysql
make
# or for containerized: docker pull proxysql/proxysql

ProxySQL requires a C++ build environment (g++/clang), standard Linux development headers, and for testing: MySQL/PostgreSQL client libraries. Review the Dockerfile in the repo for exact dependencies, or use pre-built p…

Daily commands:

# Build from source
make -j$(nproc)
# or build with specific options
make -f Makefile OPTIONS="..."

# Run the proxy
./proxysql -c /etc/proxysql.cnf
# or with systemd (if installed from packages)
sudo systemctl start proxysql

# Access admin interface on port 6032
mysql -h 127.0.0.1 -P 6032 -u admin -padmin

…shortened for this brief.

Key cautions & unknowns

• Solo or near-solo (1 contributor active in recent commits)
• GPL-3.0 is copyleft — check downstream compatibility
• 1. Configuration is two-phase: changes made via admin interface (port 6032) are volatile until SAVE CONFIG TO DISK — if you only modify /etc/proxysql.cnf and restart, changes are lost if .db file exists. 2) Default…
• Published-advisory coverage was unavailable for the captured dependencies.
• Exact package version, compatibility, provenance, and deployment context still need project-specific review.

Sources

• Repository source
• Open issues
• Recent pull requests

Evidence note

Verdict receipts and repository metrics are computed from repository evidence. Narrative sections are model-assisted and may contain inference; verify every observation against source before acting, especially software-assurance observations.

---

For the complete agent context, use the CLAUDE.md or Cursor rules export.