> For the complete documentation index, see [llms.txt](https://docs.enginsight.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.enginsight.com/docs/knowledge-base/english/configuration/what-configuration-adjustments-do-i-need-to-make-in-enginsight-if-i-use-a-proxy.md).

# What configuration adjustments do I need to make in Enginsight if I use a proxy?

If you use Enginsight with a proxy, the proxy environment must be configured [system-wide on all Enginsight servers](#id-1-configure-the-proxy-environment-system-wide), for the [Docker daemon](#id-2-configure-the-proxy-environment-for-the-docker-daemon), and in [specific Docker containers](#id-3-add-the-proxy-environment-to-individual-docker-containers).

In this article, we will show you which configuration adjustments you need to make.

***

## 1 – Configuring the Proxy Environment System Wide

First, the proxy environment must be configured *system-wide* so that the respective Enginsight servers can receive system updates.

The following servers are affected:

* Application Server
* Database Server
* Component Server
* Server for Enginsight Services (in a [load-balanced setup](https://docs.enginsight.com/docs/manual/english/installation-und-konfiguration/installation-and-configuration/load-balanced-setup))
* SIEM Management Server
* SIEM Index Server

Follow these steps **on** **each affected server**:

{% stepper %}
{% step %}
Log in to the respective server.
{% endstep %}

{% step %}
Open the system directory using the following command:

```
sudo nano /etc/environment
```

{% endstep %}

{% step %}
Add the proxy environment variables as follows:

```
HTTP_PROXY=http://<ProxyDomain>:<ProxyPort>/
HTTPS_PROXY=http://<ProxyDomainForHTTPS>:<ProxyPortForHTTPS>/
NO_PROXY="<ProxyException1>,<ProxyException2>"
```

{% hint style="info" %}
Remember to replace the placeholders in `<>` accordingly:

* `<ProxyDomain>`
* `<ProxyPort>`
* `<ProxyDomainForHTTPS>`
* `<ProxyPortForHTTPS>`
* `<ProxyException>`
  {% endhint %}
  {% endstep %}

{% step %}
Save the changes to the file (**Ctrl** + **o**) and confirm the save process. Close the file (**Ctrl** + **x**).
{% endstep %}

{% step %}
Log in to the system anew using the following command:

```
exec su -1 $USER
```

{% endstep %}
{% endstepper %}

***

## 2 – Configuring the Proxy Environment for the Docker Daemon

After configuring the proxy environment system-wide, you also need to configure it specifically for the Docker daemon on each server that has Docker installed.

The following servers are affected:

* Application Server
* Server for Enginsight Services (in a [load-balanced setup](https://docs.enginsight.com/docs/manual/english/installation-und-konfiguration/installation-and-configuration/load-balanced-setup))
* SIEM Management Server
* SIEM Index Server

Follow these steps **on each affected server**:

{% stepper %}
{% step %}
Log in to the respective server.
{% endstep %}

{% step %}
If it does not already exist, create the directory **/etc/systemd/system/docker.service.d/** using the following command:

```
sudo mkdir -p /etc/systemd/system/docker.service.d/
```

{% endstep %}

{% step %}
Open the file **http-proxy.conf** using the following command:

```
sudo nano /etc/systemd/system/docker.service.d/http-proxy.conf
```

{% endstep %}

{% step %}
Add the proxy environment variables as follows:

```
[Service]
Environment="HTTP_PROXY=http://<ProxyDomain>:<ProxyPort>/"
Environment="HTTPS_PROXY=http://<ProxyDomainForHTTPS>:<ProxyPortForHTTPS>/"
Environment="NO_PROXY=<ProxyException1>,<ProxyException2>"
```

{% hint style="info" %}
Remember to replace the placeholders in `<>` accordingly:

* `<ProxyDomain>`
* `<ProxyPort>`
* `<ProxyDomainForHTTPS>`
* `<ProxyPortForHTTPS>`
* `<ProxyException>`
  {% endhint %}
  {% endstep %}

{% step %}
Save the changes to the file (**Ctrl** + **o**) and confirm the save process. Close the file (**Ctrl** + **x**).
{% endstep %}

{% step %}
Reload the Docker daemon using the following command:

```
sudo systemctl daemon-reload
```

{% endstep %}

{% step %}
Restart Docker using the following command:

```
sudo systemctl restart docker
```

{% endstep %}
{% endstepper %}

***

## 3 – Adding the Proxy Environment to Individual Docker Containers

To ensure that the Enginsight Docker containers run correctly through the proxy, the proxy environment should also be added to the required containers.

### Docker Containers on the Enginsight Application Server

On the Application Server, the proxy environment must be added to the Docker containers `ui-m1` and `server-m2`.

Follow these steps:

{% stepper %}
{% step %}
Navigate to the Enginsight installation directory using the following command:

```
cd /opt/enginsight/enterprise
```

{% endstep %}

{% step %}
Open the Docker configuration file using the following command:

```
sudo nano docker-compose.yml
```

{% endstep %}

{% step %}
Navigate to the Docker containers `ui-m1` and `server-m2` and add the following to each container:

```
environment:
    - http_proxy=http://<ProxyDomain>:<ProxyPort>
    - https_proxy=http://<ProxyDomainForHTTPS>:<ProxyPortForHTTPS>
    - no_proxy=<ProxyException1>,<ProxyException2>
```

{% hint style="info" %}
Remember to replace the placeholders in `<>` accordingly:

* `<ProxyDomain>`
* `<ProxyPort>`
* `<ProxyDomainForHTTPS>`
* `<ProxyPortForHTTPS>`
* `<ProxyException>`
  {% endhint %}
  {% endstep %}

{% step %}
Save the changes to the configuration file (**Ctrl** + **o**) and confirm the save process. Close the file (**Ctrl** + **x**).
{% endstep %}

{% step %}
Run the setup script for the Application Server anew using the following command to apply your changes:

```
sudo ./setup.sh
```

{% endstep %}
{% endstepper %}

### Docker Containers on the SIEM Management Server

On the SIEM Management Server, the proxy environment must be added to the Docker containers `solr`, `loggernaut`, and `traicer`.

{% hint style="warning" %}
**Please note**: If you have installed the SIEM component Tracer on a server other than the SIEM Management Server, you must also perform the corresponding steps there.
{% endhint %}

Follow these steps:

{% stepper %}
{% step %}
Log in to the SIEM Management Server.
{% endstep %}

{% step %}
Navigate to the Enginsight installation directory using the following command:

```
cd /opt/enginsight/enterprise
```

{% endstep %}

{% step %}
Open the Docker configuration file using the following command:

```
sudo nano docker-compose.yml
```

{% endstep %}

{% step %}
Navigate to the Docker containers `solr`, `loggernaut`, and `traicer` and add the following to each container:

```
environment:
    - http_proxy=http://<ProxyDomain>:<ProxyPort>
    - https_proxy=http://<ProxyDomainForHTTPS>:<ProxyPortForHTTPS>
    - no_proxy=<ProxyException1>,<ProxyException2>
```

{% hint style="info" %}
Remember to replace the placeholders in `<>` accordingly:

* `<ProxyDomain>`
* `<ProxyPort>`
* `<ProxyDomainForHTTPS>`
* `<ProxyPortForHTTPS>`
* `<ProxyException>`
  {% endhint %}
  {% endstep %}

{% step %}
Save the changes to the configuration file (**Ctrl** + **o**) and confirm the save process. Close the file (**Ctrl** + **x**).
{% endstep %}

{% step %}
Restart the Docker containers using the following command to apply the changes:

```
sudo docker-compose up -d
```

{% endstep %}
{% endstepper %}

***