Skip to main content

Download and Install ProxySQL

ProxySQL offers packaged releases for multiple operating system distributions. Install packages directly from the GitHub Releases Page or via RPM/DEB repositories.

Supported Operating Systems​

DistributionVersions
RedHat & CentOS10, 9, 8*, 7*
Amazon Linux2023, 2*
Debian13, 12, 11*, 10*
Ubuntu24, 22, 20*, 18*, 16*
Almalinux10, 9, 8
OpenSUSE Leap15, 16

* ProxySQL v2.7.x and older releases only.

Docker and Kubernetes deployment options are available via DockerHub and the ProxySQL Kubernetes repository.

Currently Maintained Releases​

  • ProxySQL Core 3.0.x Series (GA)
  • ProxySQL Core 2.7.x Series (GA)
  • ProxySQL Core 2.6.x Series (GA)
  • ProxySQL Core 2.5.x Series (GA)
  • ProxySQL Core 2.4.x Series (GA)
  • ProxySQL Core 2.3.x Series (GA)
  • ProxySQL Core 2.2.x Series (GA)
  • ProxySQL Binlog Reader 2.x Series (GA)

Installing Packages Directly​

Download from the GitHub Release Page and install with your package manager:

wget https://github.com/sysown/proxysql/releases/download/v3.0.5/proxysql_3.0.5-ubuntu22_amd64.deb
dpkg -i proxysql_3.0.5-ubuntu22_amd64.deb

Installing from Repositories​

Ubuntu / Debian​

apt-get install -y --no-install-recommends lsb-release wget apt-transport-https ca-certificates gnupg

# Add repository key
wget -nv -O /etc/apt/trusted.gpg.d/proxysql-3.0.x-keyring.gpg \
  'https://repo.proxysql.com/ProxySQL/proxysql-3.0.x/repo_pub_key.gpg'

# Add repository
echo deb https://repo.proxysql.com/ProxySQL/proxysql-3.0.x/$(lsb_release -sc)/ ./ \
  | tee /etc/apt/sources.list.d/proxysql.list

# Install
apt-get update
apt-get install proxysql

To install a specific version:

apt-get install proxysql=3.0.5-ubuntu22

For older series replace proxysql-3.0.x in the repository URL with proxysql-2.7.x, proxysql-2.6.x, etc.

RedHat / CentOS​

cat <<EOF | tee /etc/yum.repos.d/proxysql.repo
[proxysql_repo]
name=ProxySQL repository
baseurl=https://repo.proxysql.com/ProxySQL/proxysql-3.0.x/centos/\$releasever
gpgcheck=1
gpgkey=https://repo.proxysql.com/ProxySQL/proxysql-3.0.x/repo_pub_key
EOF

yum install proxysql

Amazon Linux​

Use CentOS packages (CentOS 9 for Amazon Linux 2023; CentOS 7 for Amazon Linux 2):

cat <<EOF | tee /etc/yum.repos.d/proxysql.repo
[proxysql_repo]
name=ProxySQL repository
baseurl=https://repo.proxysql.com/ProxySQL/proxysql-3.0.x/centos/9
gpgcheck=1
gpgkey=https://repo.proxysql.com/ProxySQL/proxysql-3.0.x/repo_pub_key
EOF

yum install proxysql

Almalinux​

cat <<EOF | tee /etc/yum.repos.d/proxysql.repo
[proxysql_repo]
name=ProxySQL repository
baseurl=https://repo.proxysql.com/ProxySQL/proxysql-3.0.x/almalinux/\$releasever
gpgcheck=1
gpgkey=https://repo.proxysql.com/ProxySQL/proxysql-3.0.x/repo_pub_key
EOF

yum install proxysql

OpenSUSE Leap​

zypper addrepo -g -n 'ProxySQL repository' \
  'https://repo.proxysql.com/ProxySQL/proxysql-3.0.x/opensuse/$releasever_major' proxysql

zypper --gpg-auto-import-keys install proxysql

Running ProxySQL with Docker​

Configuration File​

Create a basic proxysql.cnf for development and testing:

datadir="/var/lib/proxysql"

admin_variables=
{
    admin_credentials="admin:admin;radmin:radmin"
    mysql_ifaces="0.0.0.0:6032"
}

mysql_variables=
{
    threads=4
    max_connections=2048
    default_query_delay=0
    default_query_timeout=36000000
    have_compress=true
    poll_timeout=2000
    interfaces="0.0.0.0:6033"
    default_schema="information_schema"
    stacksize=1048576
    server_version="5.5.30"
    connect_timeout_server=3000
    monitor_username="monitor"
    monitor_password="monitor"
    monitor_history=600000
    monitor_connect_interval=60000
    monitor_ping_interval=10000
    monitor_read_only_interval=1500
    monitor_read_only_timeout=500
    ping_interval_server_msec=120000
    ping_timeout_server=500
    commands_stats=true
    sessions_sort=true
    connect_retries_on_failure=10
}

Run the Container​

docker run -p 16032:6032 -p 16033:6033 -p 16070:6070 \
  -d -v /path/to/proxysql.cnf:/etc/proxysql.cnf \
  proxysql/proxysql
note

A second pair of admin credentials (e.g. radmin:radmin) is required to connect from outside the container.

For Kubernetes, sample Helm charts are available in the ProxySQL Kubernetes GitHub Repository.

Next Steps​

See First Steps After Installing for post-installation guidance.