proxyweb/proxyweb repository overview

⁠ProxyWeb

A modern, open-source web UI for managing ProxySQL⁠ servers.

⁠Features

• Multi-server management — switch between ProxySQL instances from the nav bar
• Table browser — view, search, sort, and paginate any ProxySQL table
• Inline editing — insert, update, and delete rows directly in the browser
• SQL query editor — run ad-hoc queries with quick-query shortcuts for common operations
• Query history — persistent per-server history with dropdown recall and full history page
• Config diff — compare Disk / Memory / Runtime layers side by side, spot drift instantly
• Role-based access — admin and read-only users with separate credentials
• Settings UI — edit config through a structured form or raw YAML editor

Config diff view	SQL editor with quick queries

⁠Quick Start

docker run -h proxyweb --name proxyweb -p 5000:5000 -d proxyweb/proxyweb:latest

Open http://<host>:5000 and log in with the default credentials (admin / admin42).

⁠Environment Variables

⁠Webserver

⁠Web UI Credentials

⁠Per-Server DSN

Replace <SERVERNAME> with the uppercase server key from config:

Example:

docker run -h proxyweb --name proxyweb -p 5000:5000 \
  -e PROXYWEB_SERVER_PROXYSQL_HOST=proxysql.local \
  -e PROXYWEB_SERVER_PROXYSQL_USER=radmin \
  -e PROXYWEB_SERVER_PROXYSQL_PASSWORD=radmin \
  -d proxyweb/proxyweb:latest

Or place variables in a .env file and mount it at /app/.env (or set PROXYWEB_ENV_FILE to a custom path). The entrypoint loads it automatically.

⁠Bind-Mount Config

To persist configuration across container restarts:

docker run -h proxyweb --name proxyweb -p 5000:5000 \
  -v /path/to/config.yml:/app/config/config.yml \
  -d proxyweb/proxyweb:latest

⁠Default Credentials

The login page shows a hint when default credentials are still in use. Change them in Settings or via environment variables after first login.

⁠Remote ProxySQL Access

ProxySQL only allows local admin connections by default. To enable remote access:

SET admin-admin_credentials="admin:admin;radmin:radmin";
LOAD ADMIN VARIABLES TO RUNTIME;
SAVE ADMIN VARIABLES TO DISK;

Then configure ProxyWeb with host, user: radmin, passwd: radmin, port: 6032.

⁠Supported Architectures

Build for any platform using the Makefile:

make proxyweb-build                        # linux/amd64 (default)
make proxyweb-build PLATFORM=linux/arm64   # ARM64

⁠Source Code

github.com/miklos-szel/proxyweb⁠