Download locations for Percona build of ProxySQL and ProxySQL admin tools¶

This task guide documents download locations for the Percona build of ProxySQL and Percona admin tools.

Start here

Servers with Percona repositories install ProxySQL through the package manager installation guide. Install the latest ProxySQL 3 release with the proxysql3 package. Example repositories include those used for Percona XtraDB Cluster.

Use the following guide when you browse builds on the Percona download site, install from a binary tarball, or download packages for an offline install.

Select a ProxySQL product line¶

Percona recommends the latest ProxySQL 3 release for standard deployments. See release notes for the current version and the compatibility note on the home page.

Review the following table before you open the Percona download page.

Your situation	What to select
Air-gapped server, custom layout, or no package manager	ProxySQL 3 binary tarball; see tarball installation guide
Debian or Ubuntu server with Percona repositories	`proxysql3` through the package manager installation guide
Percona XtraDB Cluster with proxysql-admin	ProxySQL 3, latest version
RHEL-family server with Percona repositories	`proxysql3` through the package manager installation guide
Standard MySQL-compatible deployment	ProxySQL 3, latest version
Existing ProxySQL 2.x deployment or version lock	ProxySQL 2.x matching your installed release
pxc_scheduler_handler on ProxySQL 2.x only	ProxySQL 2.4.2 or later

Percona download packages can include the following components:

proxysql-admin — configures Percona XtraDB Cluster nodes in ProxySQL
pxc_scheduler_handler — automates failover on supported ProxySQL versions
ProxySQL — the proxy daemon

Download files from the Percona download page¶

Complete the following steps on the Percona ProxySQL download page:

Open the download page in a browser.
Select Installation Options.
Select a Product Group value. Choose ProxySQL 3 for the latest release. Choose ProxySQL 2 only for an existing 2.x deployment or a version lock. ProxySQL version 1 is not actively maintained.
Select the latest Version value for ProxySQL 3. For ProxySQL 2, select the version that matches your environment.
Select a Platform value for your Linux distribution. Available distributions depend on the selected version.

After you complete these steps, the download page lists available files. Package files use the .deb or .rpm extension for your platform. Generic Linux builds list tarball file names.

Download all required packages as a single tar archive, or download packages individually.

Download binary tarballs¶

Select Platform, Linux, and Generic to list tarball binaries. See the tarball installation guide for installation steps.

Note

pxc_scheduler_handler is included in ProxySQL 3 releases. On ProxySQL 2.x, the tool requires version 2.4.2 or later.

Install or configure ProxySQL after download¶

Select the guide that matches your installation method:

Binary tarball — Install Percona build of ProxySQL binary tarball
Docker image — Run Docker in the installation guide
Package manager (APT or YUM) — Install Percona build of ProxySQL and the admin tools
Percona XtraDB Cluster configuration — proxysql-admin utility
ProxySQL service control — Start and stop ProxySQL

Locate source code repositories¶

The following table lists source repositories for ProxySQL and Percona admin tools.

Component	Repository
Percona proxysql-admin tool	percona/proxysql-admin-tool
ProxySQL upstream	sysown/proxysql
This documentation	percona/proxysql-admin-tool-doc

Last update: 2026-06-12