Recommendation when using an antivirus on a server with a CloudBees CI instance
- CloudBees CI (CloudBees Core) on traditional platforms - Client Master
- CloudBees CI (CloudBees Core) on traditional platforms - Operations Center
- CloudBees Jenkins Platform - Client Master
- CloudBees Jenkins Platform - Operations Center
- CloudBees Jenkins Distribution
- Jenkins LTS
While CloudBees has no specific recommendations for antiviruses to be used in general on servers which are running your instance we have observed possible performance issues from said setup.
Specifically, when using any antivirus on the same server which is running your CloudBees CI/Jenkins instance for best practice it is recommended to exclude any and all Jenkins directories from an antivirus scan.
$JENKINS_HOME should be at the following:
For CloudBees Jenkins Platform (CJP), Jenkins LTS and CloudBees Jenkins Distribution (CJD)
$JENKINS_HOMEby default is set to
For CloudBees Core/CI the default
$JENKINS_HOMElocation is set to
/var/lib/cloudbees-core-cmfor Masters/Controllers and
/var/lib/cloudbees-core-ocfor the CJOC.
Excluding the location of these directories from being scanned by any antivirus will improve performance when using an antivirus.
If performance issues persist post exclusion of the Jenkins directory it may be that the antivirus process itself is causing a performance deprecation server wide due to the resources being consumed.
Otherwise, if disabling the antivirus process completely does not yield expected performance for your instance please follow Our guide here for gathering required performance data and contact CloudBees Support.
Please note if you have also added the
--webroot or the
--pluginroot startup arguments to extract the war file and plugins from outside of
$JENKINS_HOME as described in this CloudBees CI Support article linked here you will need to blacklist these directories from antivirus as well for best practices.
In addition to the CloudBees CI CJOC and Masters, any connected agents will need to have their designated workspace for CloudBees CI builds excluded from any antiviruses installed on the agent server.