ESET Online Help

Search English
Select the topic

Troubleshooting

ESET Bridge installation troubleshooting

Restart the EsetBridge service remotely

ESET Bridge logs

Clear the ESET Bridge cache

Add a firewall rule in ESET Endpoint Security to allow the ESET Bridge incoming traffic

ESET Bridge installation troubleshooting

Windows:

oIf the installation is unsuccessful, review the installation log files in the All-in-one installation package. The logs directory is the same as the directory for the All-in-one installer, for example C:\Users\Administrator\Downloads\x64\logs\

oVerify that ESET Bridge services are running in the services.msc snap-in (look for EsetBridge and EsetBridgeWatchdog).

Linux:

oVerify that the EsetBridge and EsetBridgeWatchdog services are running by executing the following commands:

sudo service EsetBridge status

 

sudo service EsetBridgeWatchdog status

 


note

By default, both services start automatically. The EsetBridgeWatchdog service monitors the EsetBridge service and restarts it when it stops.

Restart the EsetBridge service remotely

You can restart the EsetBridge service remotely from ESET PROTECT Web Console using the Run Command Client Task:

Windows: cmd /c "net stop "EsetBridge" & sc start "EsetBridge"

Linux: sudo service EsetBridge restart

ESET Bridge logs

Windows:

oC:\ProgramData\ESET\Bridge\CrashDumps

oC:\ProgramData\ESET\Bridge\Logs

oC:\ProgramData\ESET\Bridge\Proxies\Nginx\logs\cache.log

Linux:

o/var/log/eset/bridge/Bridge.log

o/var/log/eset/bridge/Watchdog.log

o/var/opt/eset/bridge/nginx/logs/cache.log

Use ESET PROTECT On-Prem to collect ESET Bridge logs

1.Open the ESET PROTECT Web Console in your web browser and log in.

2.Click Computers > Click the computer running ESET Bridge and select Details.

3.Click Logs > Log Collector > Run Log Collector to run the Log Collector task.

4.After the task finishes, click the new entry in the log list and click Download Log Collector Log to download the logs, including ESET Bridge logs.


note

If you set a custom proxy logs directory, ESET Log Collector cannot find and collect the proxy logs.

ESET Bridge log rotation

ESET Bridge has a log rotation feature that rotates logs at a certain time interval so that the log files will not be too large. A log purger functionality also removes the oldest log files to free up space.

1.Open the pkgid file in a text editor:

Windows: C:\Program Files\ESET\Bridge\pkgid

Linux: /opt/eset/bridge/etc/pkgid

2.Edit the parameters in the pkgid file:

Parameter

Description

Applies to

logger_rotation

Log file size in MB when the rotation occurs.

ESET Bridge executable logs

logger_purgeAge

Time interval in days when the purge occurs.

ESET Bridge executable logs

nginx_logger_rotation_kb

Log file size in KB when the rotation occurs.

Nginx executable logs

nginx_logger_purge_days

Time interval in days when the purge occurs.

Nginx executable logs


warning

Ensure to save the configuration file in the UTF-8 encoding. ESET Bridge cannot process files saved in the UTF-8 with BOM encoding.

3.Restart the ESET Bridge service.

Clear the ESET Bridge cache

Clearing the ESET Bridge cache by running the Clean ESET Bridge Cache Client Task (in ESET PROTECT or in ESET PROTECT On-Prem 11.1 and later) may resolve issues when ESET product upgrades or module updates fail.

Alternatively, you can clear the ESET Bridge cache manually (if you use ESET PROTECT On-Prem 11.0 and earlier):

1.Clear the contents of the ESET Bridge cache directory:


note

The paths below are the default location of the eset_cache directory. If you use a custom cache directory location, navigate to the custom cache directory.

Windows: C:\ProgramData\ESET\Bridge\Proxies\Nginx\data\eset_cache

Linux: /var/opt/eset/bridge/nginx/data/eset_cache

2.Restart the EsetBridge service to recreate the ESET Bridge cache:

Windows—Click Start > Open the services.msc > Right-click EsetBridge and select Restart.

Linux—Run the Terminal command: sudo service EsetBridge restart

Add a firewall rule in ESET Endpoint Security to allow the ESET Bridge incoming traffic

Installing ESET Bridge on Windows 10 or 11 is not supported. If you have installed ESET Bridge on a computer running ESET Endpoint Security, you must add a firewall rule in ESET Endpoint Security to allow the ESET Bridge incoming traffic:

1.Open the ESET Endpoint Security main program window.

2.Press F5 to access Advanced setup.

3.Click Protections > Network access protection, expand Firewall and click Edit next to Rules.

4.Click Add.

5.Type the rule Name and enable the Enabled toggle.

6.Set the rule parameters:

Action

Allow

Application

%PROGRAMFILES%\\ESET\\Bridge\\Proxies\\Nginx\\nginx.exe

Direction

In

IP protocol

TCP & UDP

Local port

3128

7.Click OK > OK.