# Install Percona build of ProxySQL binary tarball

If installing [Percona build of ProxySQL with a package manager](install-v2.md) 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.

## Version changes

### CentOS 6

Starting with [_ProxySQL 2.3.2-1.2_](release-notes-2.3.2-1.md), 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](https://www.percona.com/blog/spring-cleaning-discontinuing-rhel-6-centos-6-glibc-2-12-and-32-bit-binary-builds-of-percona-software/)

### OpenSSL 1.1.1

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.

## Format

The tar file binary have the following format:

proxysql-<version>-<operating_system>-<architecture>-<glibc_version>.tar.gz

The following is an example of a tar file binary for ProxySQL 3.0.1

 proxysql-3.0.1-Linux-x86_64.glibc2.31.tar.gz 
 
## Download the file

[Follow the instructions in `Download locations for Percona’s build of ProxySQL and ProxySQL admin tools`](where-to-download-proxysql.md)

Be sure to select the appropriate file for your operating system based on the `glibc version` used. Verify that you're installing the correct ProxySQL version for your environment, such as `proxysql2` or `proxysql3`.

??? note "tar files for ProxySQL 2.4.4 and higher"

    | Name                                              | Description                           |
    | ------------------------------------------------- | ------------------------------------- |
    | proxysql-2-<version>-Linux-x86_64.glibc2.23.xenial.tar.gz  | For Ubuntu 16.04 `xenial` only |
    |proxysql-2-<version>-Linux-x86_64.glibc2.17.tar.gz          | For every supported operating system |
    |proxysql-2-<version>-Linux-x86_64.glibc2.27.tar.gz          | For every supported operating system but `xenial`. For CentOS 7, install OpenSSL 1.1.1, if needed.  |

??? note "tar files from ProxySQL 2.3.2-1.2 to ProxySQL 2.4.3"

  | Name                                              | Description                           |
  | ------------------------------------------------- | ------------------------------------- |
  | proxysql-2-<version>-Linux-x86_64.glibc2.23.xenial.tar.gz  | For Ubuntu 16.04 `xenial` only |

??? note "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.

## Install the file

1.  Navigate to the downloaded tar file.

2.  Extract the files with the following commands:

    ??? "Extract ProxySQL 2.0.14 or higher"

        ```{.bash data-prompt="$"}
        $ tar xzf proxysql-<version>-Linux-<PLATFORM-ARCHITECTURE>-<glibc version>.tar.gz
        $ cd proxysql-<VERSION>-Linux-<PLATFORM-ARCHITECTURE>
        ```

    ??? "Extract ProxySQL 2.0.13 or lower"

        ```{.bash data-prompt="$"}
        # 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>
        ```

3.  Create a directory to store the _ProxySQL_ data.

      ```{.bash data-prompt="$"}
      $ mkdir /home/user/data
      ```

4.  In the configuration file, update the `datadir` value to point
    to the created data directory.

      ```{.text .no-copy}
      datadir="/home/user/data"
      ```

5.  Set the other options, as needed.

## MySQL 8.4 and Percona Server for MySQL 8.4 considerations

--8<--- "note-8.4.md"