# Install the XDR Proxy

## Prerequisites

### Aerospike Database change notification configuration

Streaming from Aerospike requires you to configure your Aerospike database to send change notifications. To learn how, see [Configure change notification](https://aerospike.com/docs/connectors/streaming/common/change-notification).

## Deploying on Docker

Aerospike provides Docker images for the XDR Proxy on Docker Hub.

Terminal window

```shell
sudo docker run \

 -v <path to local aerospike-xdr-proxy.yml>:/etc/aerospike-xdr-proxy/aerospike-xdr-proxy.yml \

 container.aerospike.com/aerospike/aerospike-xdr-proxy:latest
```

`<path to local aerospike-xdr-proxy.yml>`: The path (including the name) of the configuration file in your local filesystem.

## Installing on Linux

### Prerequisites

#### Supported operating systems

The connector is supported on the following operating systems:

-   RHEL/CentOS (8 and 9)
-   Ubuntu (20.04, 22.04 and 24.04 LTS)
-   Debian (11, 12 and 13)
-   Amazon Linux 2023

#### Java Runtime Environment

This connector is a Java web-application that requires Java 11 or later. Both Oracle and OpenJDK Java Runtime Environments are supported.

Java 17 is supported with XDR Proxy versions 1.2.0 and higher.

## Installation

The following installation steps apply to both the Debian (\*.deb) and RHEL (\*.rpm) packages. We point out any significant differences between the supported platforms.

### Install Java 11 or later version

The XDR Proxy package does not include a Java runtime environment. Most supported platforms provide official JDK 11 packages. For platforms that do not, you can get Oracle’s JDK 11 builds from [jdk.java.net/11/](https://jdk.java.net/11/).

**RHEL, CentOS, etc.**

Terminal window

```shell
$ sudo yum install java-11-openjdk
```

**Debian, Ubuntu, etc.**

Terminal window

```shell
$ sudo apt-get install openjdk-11-jre
```

**Amazon Linux etc.**

Terminal window

```shell
sudo dnf install java-11-openjdk
```

### Install connector package

**RHEL, CentOS, etc.**

Terminal window

```shell
sudo rpm -i aerospike-xdr-proxy-3.2.16-1.noarch.rpm
```

**Debian, Ubuntu, etc.**

Terminal window

```shell
sudo dpkg -i aerospike-xdr-proxy-3.2.16.all.deb
```

**Amazon Linux, etc.**

Terminal window

```shell
sudo rpm -i aerospike-xdr-proxy-3.2.16-1.noarch.rpm
```

### Verify connector configuration

The configuration file for the connector is in `/etc/aerospike-xdr-proxy/`. Update it if necessary. For details on how to configure the connector, see the [Configuration Guide](https://aerospike.com/docs/database/8.0.0/manage/xdr/proxy/config).

### Start the connector

The connector package includes a systemd service definition. The installation procedure creates an aerospike-xdr-proxy service.

Enable the connector to start on system startup or reboot:

Terminal window

```shell
$ sudo systemctl enable aerospike-xdr-proxy
```

To start the connector service run:

Terminal window

```shell
$ sudo systemctl start aerospike-xdr-proxy
```

[Configure Connector](https://aerospike.com/docs/database/8.0.0/manage/xdr/proxy/config)