2026-09-03 · 3 min · BitNinja Team · AI generated
New BitNinja Agent 3.17.0: Modernized PID Paths and Improved Service Reliability
This BitNinja release modernizes PID handling, improves service startup reliability, reduces CaptchaHttp CPU load, and adds WAF Pro static-file exclusions.

BitNinja Linux Agent: Modernized PID Paths and Improved Service Reliability
This BitNinja Linux Agent release updates PID file handling across several modules, improves service startup coordination, and addresses an issue that could lead to high CPU load in CaptchaHttp. It is available through the beta and frequent update channels.
Modernized PID File Handling
BitNinja now migrates PID file references from the deprecated
/var/run
directory to the modern
/run
directory. This aligns PID file locations with current Linux FHS and systemd practices, where
/run
is typically provided as a tmpfs.
The update also relocates the BitNinja MQ and Process Analysis PID files to
/run
, while Reliable Auto Update receives consistent PID file handling. Dispatcher, WAF3, and related services also receive updated daemon PID path configuration.
Service Startup and Rule Application
PortHoneypot now waits until all critical dependencies are available before starting. This prevents premature startup and helps ensure consistent rule application.
CaptchaHttp CPU Load
CaptchaHttp includes a fix for an issue that could lead to high CPU load.
WAF Pro Optimization
WAF Pro now supports a static file exclude regex for optimization. This allows static files to be handled according to the configured exclusion pattern.
Service and Log Directory Configuration
The release updates log directory permissions for several BitNinja services and standardizes them where specified. Dispatcher, Process Analysis, Reliable Auto Update, and WAF3 receive log directory permission updates, including consistent
0750
permissions where applicable. WAF3 also receives configured service PID file and log permission settings.
Changelog:
bitninja (version not provided)
-
General
-
Migrate all PID file references from the deprecated
/var/rundirectory to the modern/rundirectory.
-
Migrate all PID file references from the deprecated
-
CaptchaHttp
- Fix an issue that could lead to high CPU load.
-
PortHoneypot
- Ensure a blocking wait until all critical dependencies are met, preventing premature startup and ensuring consistent rule application.
-
WAF Pro
- Introduce a static file exclude regex for optimization.
-
BitNinja Dispatcher 1.1.0
- Update log directory permissions and daemon PID path.
-
BitNinja MQ 1.1.0
-
Relocate the bitninja-mq PID file to
/run.
-
Relocate the bitninja-mq PID file to
-
BitNinja Process Analysis 1.1.0
-
Relocate PID files to
/run. -
Ensure the log directory has consistent
0750permissions.
-
Relocate PID files to
-
BitNinja Reliable Auto Update 1.1.0
- Ensure log directory permissions and consistent PID file handling.
-
BitNinja WAF3 1.1.0
- Configure the bitninja-waf3 service PID file and log permissions.
To ensure you’re running the latest version, check your update channel settings in the BitNinja Console using RAU. If you have specific configurations or applications preventing automatic updates, please refer to our documentation for instructions on manual updates and RAU configuration .
If you'd like to read more about previous releases, check the Changelog anytime.
Alternatively, if you would like to see your feature request show up here, don't forget to cast your vote .