Skip to content
logo
Percona ProxySQL admin tools
Install ProxySQL 2.x.x binary tarball
Initializing search
    percona/proxysql-admin-tool-doc
    percona/proxysql-admin-tool-doc
    • Home
      • Use ProxySQL 1.x.x with ProxySQL Admin
      • Install ProxySQL 1.x.x
      • Install ProxySQL 1.X from a binary tarball
      • Configure ProxySQL 1.x.x
        • Download locations for ProxySQL 2.x.x and ProxySQL admin utilities
        • Install ProxySQL 2.x.x and the admin utilities
        • Install ProxySQL 2.x.x binary tarball
        • Build the pxc_scheduler_handler tool
        • Start and stop ProxySQL
        • Upgrade ProxySQL
        • Uninstall ProxySQL 2.x.x
          • ProxySQL Admin tool changes
          • ProxySQL 2.x and proxysql-admin utility
          • The proxysql-admin functions
          • ProxySQL 2.x.x and pxc_scheduler_handler tool
          • pxc-scheduler-handler configuration
          • pxc_scheduler_handler statements
          • pxc-scheduler-handler options
          • Known issues in pxc_scheduler_handler
      • Release notes index
      • ProxySQL 2.4.8 and ProxySQL admin tools (2023-03-15)
      • ProxySQL 2.4.7 and ProxySQL admin tools (2023-02-14)
      • ProxySQL 2.4.4-1.2 and ProxySQL admin tools (2022-11-08)
      • ProxySQL 2.4.4 and ProxySQL admin tools (2022-10-04)
      • ProxySQL 2.4.3 and ProxySQL admin tools (2022-08-31)
      • ProxySQL 2.4.2 and proxysql admin tools (2022-08-10)
      • ProxySQL 2.3.2-1.2, proxysql-admin, and percona-scheduler-admin (2022-06-15)
      • ProxySQL 2.3.2 and proxysql-admin (2021-11-03)
      • ProxySQL 2.2.0 and proxysql-admin (2021-08-10)
      • ProxySQL 2.1.1 and proxysql-admin (2021-07-09)
      • ProxySQL 2.0.18 and proxysql-admin (2021-04-19)
      • ProxySQL 2.0.17 and proxysql-admin (2021-04-06)
      • ProxySQL 2.0.15 and proxysql-admin (2020-11-17)
      • ProxySQL 2.0.14 and proxysql-admin (2020-09-24)
      • ProxySQL 2.0.13 and proxysql-admin (2020-08-05)
      • ProxySQL 2.0.12 and proxysql-admin (2020-06-11)
      • ProxySQL 2.0.7 and proxysql-admin (2019-10-23)
      • ProxySQL 2.0.6 and proxysql-admin (2019-08-21)
      • ProxySQL 2.0.5 and proxysql-admin (2019-11-23)
      • ProxySQL 2.0.4 and proxysql-admin (2019-05-28)
      • ProxySQL 2.0.3 and proxysql-admin (2019-05-07)
      • ProxySQL 1.4.16 and proxysql-admin (2020-02-11)
      • ProxySQL 1.4.12 and proxysql-admin (2018-11-13)
      • ProxySQL 1.4.8 and proxysql-admin (2018-05-22)
      • ProxySQL 1.4.7 and proxysql-admin (2018-04-16)
      • ProxySQL 1.4.6 and proxysql-admin (2018-03-12)
      • ProxySQL 1.4.5 and proxysql-admin (2018-02-15)
      • ProxySQL 1.4.4 and proxysql-admin (2018-01-18)

    Install ProxySQL 2.x.x binary tarball¶

    If installing ProxySQL 2 with a package manager is not an option in your environment, you can install from a binary tarball. The difference between versions is the available tar files or the command to extract the file.

    Starting with ProxySQL 2.3.2-1.2, Percona no longer provides a tarball for CentOS 6. For more information, see Spring Cleaning: Discontinuing RHEL 6/CentOS 6 (glibc2.12) and 32-bit Binary Builds of Percona Software

    The password-based file encryption requires OpenSSL 1.1.1, but Ubuntu 16.04 does not support this OpenSSL version. A special statically linked OpenSSL 1.1.1 binary is packaged with the executable. This packaged binary avoids conflicts with the system OpenSSL and any shared libraries. Each new release rebuilds the binary.

    Follow these steps:

    1. In Download ProxySQL2, select the version.

    2. In the Software field, select Linux - Generic.

    3. Select the tar file.

      tar files for ProxySQL 2.3.2-1.2 and higher
      Name Description
      proxysql-2--Linux-x86_64.glibc2.23.tar.gz For every supported operating system.
      tar files from ProxySQL 2.0.15 to ProxySQL 2.3.2
      Name Description
      proxysql-2.0.XX-Linux-x86_64.glibc2.12.tar.gz For every supported operating system but xenial. For CentOS 7, install OpenSSL 1.1.1, if needed.
      proxysql-2.x.xx-Linux-x86_64.glibc2.17.tar.gz For every supported operating system
      proxysql-2.0.XX-Linux-x86_64.glibc2.23.xenial.tar.gz For Ubuntu 16.04 xenial only.

      See ProxySQL 2.0.15 and proxysql-admin

    4. Navigate to the downloaded tar file.

    5. Extract the files with the following commands:

      Extract ProxySQL 2.0.14 or higher
      $ # Extract the files to the download destination directory
      $ tar xzf proxysql-2.X.X-<PLATFORM-ARCHITECTURE*>.tar.gz
      $ # Change to the directory that contains the extracted files
      $ cd proxysql-<VERSION>-Linux-<PLATFORM-ARCHITECTURE>
      
      Extract ProxySQL 2.0.13 or lower
      # Extract the files (assumes you have changed to the download destination directory)
      $ tar xzf proxysql-<VERSION>-<Linux-PLATFORM-ARCHITECTURE*>.tar.gz
      # Change to the directory that contains the extracted files
      $ cd proxysql-<VERSION>-Linux-<PLATFORM-ARCHITECTURE>
      
    6. Create a directory to store the ProxySQL data.

      $ mkdir /home/user/data
      
    7. In the configuration file, update the datadir value to point to the created data directory.

      datadir="/home/user/data"
      
    8. Set the other options, as needed.

    See also

    ProxySQL 2.x and proxysql-admin utility

    Contact us

    For free technical help, visit the Percona Community Forum.

    To report bugs or submit feature requests, open a JIRA ticket.

    For paid support and managed or consulting services , contact Percona Sales.


    Last update: 2023-03-24
    Percona LLC and/or its affiliates, © 2023
    Made with Material for MkDocs

    Cookie consent

    We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.