Package com.atlassian.bamboo.utils

Class SystemProperty

java.lang.Object
com.atlassian.bamboo.utils.AbstractSystemProperty
com.atlassian.bamboo.utils.SystemProperty
public class SystemProperty extends AbstractSystemProperty
This class represents system properties as constants. The system / environmental constants resolution order goes:
  1. System.getProperty (so any -Dproperty=hello will take precedent)
  2. System.getenv()
  3. Ant's Execute.getProcEnvironment()

  • Field Details

    • BAMBOO_HOME_PROPERTY_NAME

      public static final String BAMBOO_HOME_PROPERTY_NAME
      See Also:

    • BAMBOO_HOME_SHARED_PROPERTY_NAME

      public static final String BAMBOO_HOME_SHARED_PROPERTY_NAME
      See Also:

    • BAMBOO_AGENT_BROKER_URL_PROPERTY_NAME

      public static final String BAMBOO_AGENT_BROKER_URL_PROPERTY_NAME
      See Also:

    • PER_NODE_QUEUE_STATS_LOGGING_INTERVAL_MINUTES_DEFAULT

      public static final long PER_NODE_QUEUE_STATS_LOGGING_INTERVAL_MINUTES_DEFAULT
      See Also:

    • BAMBOO_HOME_FROM_ENV

      public static final SystemProperty BAMBOO_HOME_FROM_ENV
      Location of Bamboo Home. If running in HA mode, this refers to the local home.

      • Default : none
      • Usage:
        • env : BAMBOO_HOME=bamboo-home or bamboo.home=bamboo-home
        • java: -DBAMBOO_HOME=bamboo-home, -Dbamboo.home=bamboo-home

    • BAMBOO_HOME_SHARED_FROM_ENV

      public static final SystemProperty BAMBOO_HOME_SHARED_FROM_ENV
      Location of Bamboo Shared Home. Default is /shared subdirectory of bamboo.home.

      • Default : none
      • Usage:
        • env : BAMBOO_SHARED_HOME=bamboo-shared-home or bamboo.shared.home=bamboo-shared-home
        • java: -DBAMBOO_SHARED_HOME=bamboo-shared-home, -Dbamboo.shared.home=bamboo-shared-home

    • MAVEN_HOME

      public static final SystemProperty MAVEN_HOME
      Location of MAVEN 1

      • Default : none
      • Usage:
        • env : MAVEN_HOME=maven1-install
        • java: -DMAVEN_HOME=maven1-install

    • MAVEN2_HOME

      public static final SystemProperty MAVEN2_HOME
      Location of MAVEN 2

      • Default : none
      • Usage:
        • env : M2_HOME=maven2-install, MAVEN2_HOME=maven2-install
        • java: -DM2_HOME=maven2-install, -DMAVEN2_HOME=maven2-install

    • ANT_HOME

      public static final SystemProperty ANT_HOME
      Location of ANT

      • Default : none
      • Usage:
        • env : ANT_HOME=ant-install
        • java: -DANT_HOME=ant-install

    • FIND_SUCCESS_MESSAGE_IN_LAST

      public static final SystemProperty FIND_SUCCESS_MESSAGE_IN_LAST
      Number of lines for builders to look back to guarantee build successful.

      • Default : 250
      • Usage:
        • env : SUCCESS_MESSAGE_LINES=number
        • java: -DSUCCESS_MESSAGE_LINES=number

    • BUILD_SUCCESSFUL_MARKER

      public static final SystemProperty BUILD_SUCCESSFUL_MARKER
      Text the builders will look for when checking for build success.

      • Default : BUILD SUCCESS
      • Usage:
        • env : atlassian.bamboo.builder.successMarker="String"
        • java: -atlassian.bamboo.builder.successMarker="String"

    • BUILD_FAILED_MARKER

      public static final SystemProperty BUILD_FAILED_MARKER
      Text the builders will look for when checking for build failure, currently only used by ant builder

      • Default : BUILD FAILED
      • Usage:
        • env : atlassian.bamboo.builder.failedMarker="String"
        • java: -Datlassian.bamboo.builder.failedMarker="String"

    • SEARCH_BUILD_SUCCESS_FAIL_MESSAGE_EVERYWHERE

      public static final SystemProperty SEARCH_BUILD_SUCCESS_FAIL_MESSAGE_EVERYWHERE
      A workaround for BAM-4069, allows us to search for build successful/failed messages.

      • Default : false
      • Usage:
        • env : bamboo.build.searchSuccessFailMessageEverywhere="true"
        • java: -Dbamboo.build.searchSuccessFailMessageEverywhere=true

    • DISABLE_AGENT_AUTO_CAPABILITY_DETECTION

      public static final SystemProperty.BooleanSystemProperty DISABLE_AGENT_AUTO_CAPABILITY_DETECTION
      Prevents agents from automatically overriding auto-detected remote agent capabilities on new startup

      • Default : false
      • Usage:
        • env : DISABLE_AGENT_AUTO_CAPABILITY_DETECTION="true"
        • java: -DDISABLE_AGENT_AUTO_CAPABILITY_DETECTION=true

    • DISABLE_AGENT_CAPABILITY_UPDATE

      public static final SystemProperty.BooleanSystemProperty DISABLE_AGENT_CAPABILITY_UPDATE
      Prevents agents from overriding remote agent capabilities from bamboo-capabilities.properties on startup

      • Default : false
      • Usage:
        • env : bamboo.disable.capabilities.properties.file="true"
        • java: -Dbamboo.disable.capabilities.properties.file=true

    • REMOTE_AGENT_AUTHENTICATION_ENABLED

      public static final SystemProperty.BooleanSystemProperty REMOTE_AGENT_AUTHENTICATION_ENABLED
      Disables remote agent authentication on instance setup

      • Default : true
      • Usage:
        • env : bamboo.setup.remote.agent.authentication.enabled="false"
        • java: -Dbamboo.setup.remote.agent.authentication.enabled=false

    • REMOTE_AGENT_SECURITY_TOKEN_ENABLED

      public static final SystemProperty.BooleanSystemProperty REMOTE_AGENT_SECURITY_TOKEN_ENABLED
      Enables agent security token verification on instance setup

      • Default : false
      • Usage:
        • env : bamboo.setup.remote.agent.security.token.enabled="true"
        • java: -Dbamboo.setup.remote.agent.security.token.enabled=true

    • REMOTE_AGENT_SECURITY_TOKEN_VALUE

      public static final SystemProperty REMOTE_AGENT_SECURITY_TOKEN_VALUE
      Sets token value for Agent authentication (if defined bamboo won't generate new token). Token should contain only hexadecimal characters and have 40 characters length.
        Usage:
        • env : bamboo.setup.remote.agent.security.token.value="ABCDEF12345678901234abcdef0123456789abcd"
        • java: -Dbamboo.setup.remote.agent.security.token.value=ABCDEF12345678901234abcdef0123456789abcd

    • LOCAL_AGENTS_DISABLED

      public static final SystemProperty.BooleanSystemProperty LOCAL_AGENTS_DISABLED
      Disables the use of local agents for the instance.

      • Default : true
      • Usage:
        • env : bamboo.local.agents.disabled="false"
        • java: -Dbamboo.local.agents.disabled=false

    • SVN_SPOOL_TO_FILE

      public static final SystemProperty SVN_SPOOL_TO_FILE
      SVN client to use temporary file for spooling repository files

      • Default : true
      • Usage:
        • env : SVN_SPOOL_TO_FILE="false"
        • java: -DSVN_SPOOL_TO_FILE=false

    • BUILDING_DISABLED

      public static final SystemProperty BUILDING_DISABLED
      Disable triggering plans globally in Bamboo. Plan can be started manually only.

      • Default : false
      • Usage:
        • env : atlassian.bamboo.build.disable="true"
        • java: -Datlassian.bamboo.build.disable=true

    • PATH

      public static final SystemProperty PATH
      The system PATH variable. Needed so we can append to it

      • Default : "" (empty)
      • Usage:
        • env : PATH=<$PATH>, Path="String", path="String"
        • java: -DPATH=<$PATH>, -DPath="String", -Dpath="String"

    • BUILD_RESULTS_CACHE_SIZE

      public static final SystemProperty BUILD_RESULTS_CACHE_SIZE
      Make the buildresults cache configurable

      • Default : 100
      • Usage:
        • env : BUILD_RESULTS_CACHE_SIZE=number
        • java: -DBUILD_RESULTS_CACHE_SIZE=number

    • FILTER_MAVEN_LOG_FOR_DOWNLOAD_STATUS

      public static final SystemProperty FILTER_MAVEN_LOG_FOR_DOWNLOAD_STATUS
      Filter out Maven artifact download progress status message in build log.
      If set to false all messages from maven are displayed.

      • Default : true
      • Usage:
        • env : FILTER_MAVEN_LOG_FOR_DOWNLOAD_STATUS="false"
        • java: -DFILTER_MAVEN_LOG_FOR_DOWNLOAD_STATUS=false

    • SVN_WC_FORMAT

      @Deprecated public static final SystemProperty SVN_WC_FORMAT
      Deprecated.
      since 4.2.1 use AdministrationConfiguration.getRepositorySettings()

      • Default : 1.6
      • Usage:
        • env : bamboo.svn.wc.format="String"
        • java: -Dbamboo.svn.wc.format="String"
      Default format of SVN workspaces

    • SVN_CACHE_CREDENTIALS

      public static final SystemProperty SVN_CACHE_CREDENTIALS
      SVN authentication caching

      • Default : 1.5
      • Usage:
        • env : bamboo.svn.cache.credentials=true
        • java: -Dbamboo.svn.cache.credentials=true

    • LOG_LINES_FOR_NOTIFICATIONS

      public static final SystemProperty.IntegerSystemProperty LOG_LINES_FOR_NOTIFICATIONS
      Lets you control how much information is showed in notifications

      • for build completed emails the last x number of error lines will be included
      • for build errored emails the first x number of lines of the stack trace will be included
      • Default : 100
      • Usage:
        • env : bamboo.notifications.logLinesToInclude=number
        • java: -Dbamboo.notifications.logLinesToInclude=number

    • FS_TIMESTAMP_RESOLUTION_MS

      public static final SystemProperty.IntegerSystemProperty FS_TIMESTAMP_RESOLUTION_MS
      Defines the worst case resolution of times stored on filesystem. Java provides accesse only to the modification time.

    • SEND_FILE_NAMES_TO_AGENT

      public static final SystemProperty SEND_FILE_NAMES_TO_AGENT
      If your agent side plugins rely on presence of file names in BuildContext, set this property to true. Default: false.

    • ELASTIC_IMAGE_AMI_ID

      public static final SystemProperty ELASTIC_IMAGE_AMI_ID
      Lets you over ride the default elastic images used

      • Default : null
      • Usage:
        • env : bamboo.aws.amiId="String"
        • java: -Dbamboo.aws.amiId="String"

    • MAXIMUM_ALLOWED_ELASTIC_AGENT_STARTUP_TIME_MINUTES

      public static final SystemProperty.IntegerSystemProperty MAXIMUM_ALLOWED_ELASTIC_AGENT_STARTUP_TIME_MINUTES
      If the elastic agent still isn't alive after this timeout, the instance will be shut down.

    • EC2_HTTP_TUNNEL_ENABLED

      public static final SystemProperty.BooleanSystemProperty EC2_HTTP_TUNNEL_ENABLED
      Whether to enable Tunnel for http traffic to and from the agents. Defaults to true

      • Default : true
      • Usage:
        • env : bamboo.ec2.tunnel.enabled=false
        • java: -Dbamboo.ec2.tunnel.enabled="false"

    • ELASTIC_AGENT_TUNNEL_TIMEOUT_MINUTES

      public static final SystemProperty.IntegerSystemProperty ELASTIC_AGENT_TUNNEL_TIMEOUT_MINUTES
      The elastic agent tunnel timeout in minutes.

      • Default : 40
      • Usage:
        • env : bamboo.ec2.agent.tunnel.timeout=30
        • java: -Dbamboo.ec2.agent.tunnel.timeout=30

    • EC2_JMS_TUNNEL_ENABLED

      public static final SystemProperty.BooleanSystemProperty EC2_JMS_TUNNEL_ENABLED
      Whether to enable Tunnel for http and JMS traffic to and from the agents. Defaults to true.

      • Default : true
      • Usage:
        • env : bamboo.ec2.tunnel.jms.enabled=false
        • java: -Dbamboo.ec2.tunnel.jms.enabled="false"

    • ENABLE_JMS_SSL_ENDPOINT

      public static final SystemProperty.BooleanSystemProperty ENABLE_JMS_SSL_ENDPOINT
      Whether to enable SSL JMS endpoint. Defaults to true.

      • Default : true
      • Usage:
        • env : bamboo.jms.ssl.endpoint.enabled=false
        • java: -Dbamboo.jms.ssl.endpoint.enabled="false"

    • EC2_TUNNEL_KEY_LENGTH

      public static final SystemProperty.IntegerSystemProperty EC2_TUNNEL_KEY_LENGTH
      Set the key length used by EC2 tunnel encryption algorithm.
      • Default : 2048
      • Usage:
        • env : bamboo.ec2.tunnel.key.length=2048
        • java: -Dbamboo.ec2.tunnel.key.length=2048

    • EC2_IGNORE_CERT_CHECK

      public static final SystemProperty EC2_IGNORE_CERT_CHECK
      Allow EC2 agents to ignore invalid certificates, if not using the tunnel

      • Default : false
      • Usage:
        • env : bamboo.ec2.ignoreCertCheck="true"
        • java: -Dbamboo.ec2.ignoreCertCheck=true

    • ELASTIC_BAMBOO_CUSTOM_ENTITY

      public static final SystemProperty ELASTIC_BAMBOO_CUSTOM_ENTITY
      Custom EC2 Entity Name. Used by Security Groups and Key Pairs. Configure this setting if the default 'elasticbamboo' is not suitable or if you require distinct entities for shared accounts across multiple Bamboo instances

      • Default : elasticbamboo
      • Usage:
        • env : bamboo.ec2.entity.name="elasticbamboo"
        • java: -Dbamboo.ec2.entity.name=elasticbamboo

    • FIRE_INITIAL_BUILD_FOR_MANUAL_STRATEGY

      public static final SystemProperty FIRE_INITIAL_BUILD_FOR_MANUAL_STRATEGY
      Fire initial build automatically for manual build strategy on build creation

      • Default : false
      • Usage:
        • env : fire.initial.build.for.manual.strategy=true
        • java: -Dfire.initial.build.for.manual.strategy="true"

    • INITIAL_BUILD_ENABLED

      public static final SystemProperty.BooleanSystemProperty INITIAL_BUILD_ENABLED
      Enable initial build for newly created plans and plan branches.

      • Default : false
      • Usage:
        • env : bamboo.fire.initial.build.enabled=false
        • java: -Dbamboo.fire.initial.build.enabled=false

    • PATH_SET_ALLOWED

      public static final boolean PATH_SET_ALLOWED
      Whenever arbitrary path for export and backup allowed

      • Default : false (export and backup files created only in Bamboo home)
      • Usage:
        • env : bamboo.paths.set.allowed=true
        • java: -Dbamboo.paths.set.allowed=true

    • BUILD_PARENT_JAVA_IO_TMPDIR

      public static final SystemProperty BUILD_PARENT_JAVA_IO_TMPDIR
      Parent directory for temporary directories created for builds. Defaults to System.getProperty("java.io.tmpdir")
      • Default : empty
      • Usage:
        • env : bamboo.build.parent.java.io.tmpdir=String or java.io.tmpdir=String
        • java: -Dbamboo.build.parent.java.io.tmpdir=String or -Djava.io.tmpdir=String

    • EVENT_MANAGER_MAXIMUM_POOL_SIZE

      public static final SystemProperty EVENT_MANAGER_MAXIMUM_POOL_SIZE
      Optional property for tuning core pool size in Bamboo Event Manager, this will set both the core and maximum pool size

      • Default : System - ThreadPoolExecutor.getMaximumPoolSize()
      • Usage:
        • env : bamboo.event.bambooEventManager.maximumPoolSize=number
        • java: -Dbamboo.event.bambooEventManager.maximumPoolSize=number

    • DIRECTORY_SCANNING_PLUGIN_SCAN_DIR

      public static final SystemProperty DIRECTORY_SCANNING_PLUGIN_SCAN_DIR
      An optional directory to attempt to load additional plugins from. Must be a directory readable to the process.

      • Default :
      • Usage:
        • env : atlassian.bamboo.pluginScanDirectory=/path/to/plugin/directory
        • java: -Datlassian.bamboo.pluginScanDirectory="/path/to/plugin/directory"

    • ELASTIC_AGENT_LOG_AWS_ID

      public static final SystemProperty ELASTIC_AGENT_LOG_AWS_ID
      If it is set to a valid AWS id, it will be used to authenticate to S3 and copy logs there upon shutdown

      • Default : empty
      • Usage:
        • env : bamboo.ec2.agentLogAwsId=XXXXXXX
        • java: -Dbamboo.ec2.agentLogAwsId=XXXXXXX

    • ELASTIC_AGENT_LOG_AWS_SECRET

      public static final SystemProperty ELASTIC_AGENT_LOG_AWS_SECRET
      If it is set to a valid AWS id, it will be used to authenticate to S3 and copy logs there upon shutdown

      • Default : empty
      • Usage:
        • env : bamboo.ec2.agentLogSecret=XXXXXXX
        • java: -Dbamboo.ec2.agentLogSecret=XXXXXXX

    • BAMBOO_DELETION_ENABLED

      public static final SystemProperty BAMBOO_DELETION_ENABLED
      If this is set to 'false' then the background deletion service will not delete objects within Bamboo that are ImmutableDeletable.isMarkedForDeletion() This is only useful for support purposes

    • BAMBOO_RELOAD_AGENT_CLASSPATH

      public static final SystemProperty BAMBOO_RELOAD_AGENT_CLASSPATH
      When set causes the classpath.zip of the Jar Remote class loader to be reset for each agent startup

    • BAMBOO_MAX_AGENTS_LOADING

      public static final SystemProperty BAMBOO_MAX_AGENTS_LOADING
      Specifies the maximum amount of remote agents able to load at one time

    • BAMBOO_FREEMARKER_DEBUG

      public static final SystemProperty BAMBOO_FREEMARKER_DEBUG
      Unlocks different aspects of Freemarker debug output: - output template names as html comments (BAM-8006)

    • MAX_VCS_OPERATION_RETRIES

      public static final SystemProperty MAX_VCS_OPERATION_RETRIES
      Overrides the maximum number of retries for operations that fail. bamboo.vcs.retries

    • PLAN_EXECUTION_DETECTION_THREADS

      public static final SystemProperty.IntegerSystemProperty PLAN_EXECUTION_DETECTION_THREADS
      Allows for the pool size for change detection to be modified. Docs: https://hello.atlassian.net/wiki/spaces/C4L/pages/2175074305/Bamboo+PlanExec+thread+pool+on-demand+scaling

    • PLAN_EXECUTION_IDLE_TIMEOUT

      public static final SystemProperty.IntegerSystemProperty PLAN_EXECUTION_IDLE_TIMEOUT
      Determines the number of seconds after which the IDLE thread will be removed from the "BAM::PlanExec" and "ChainExec" thread pool.

    • BRANCH_CREATION_THREADS

      public static final SystemProperty.IntegerSystemProperty BRANCH_CREATION_THREADS
      Determines the number of threads in branch creation thread pool ("BAM::BranchCreation").

    • CHAIN_EXECUTION_DETECTION_THREADS

      public static final SystemProperty.IntegerSystemProperty CHAIN_EXECUTION_DETECTION_THREADS
      Determines the pool size for ChainExecutionManager. Defaults to same as PLAN_EXECUTION_DETECTION_THREADS

    • PLAN_EXECUTION_PRIORITIZING_ENABLED

      public static final SystemProperty.BooleanSystemProperty PLAN_EXECUTION_PRIORITIZING_ENABLED
      Whether Bamboo uses prioritizing algorithm to manage plans execution order. If disabled, the order follows the first in first out rule.

    • PLAN_DISABLE_ON_REPOSITORY_EXCEPTION

      public static final SystemProperty.BooleanSystemProperty PLAN_DISABLE_ON_REPOSITORY_EXCEPTION
      Disable the Plan if a repository exception is thrown. Change it with care as it may cause Plans to not get disabled under legitimate circumstances.

      • Default : true
        • env : bamboo.plan.disable.on.repository.exception=false
        • java: -Dbamboo.plan.disable.on.repository.exception=false

      Since:
      9.6.0

    • SPECS_DETECTION_THREADS

      public static final SystemProperty.IntegerSystemProperty SPECS_DETECTION_THREADS
      Allows for the pool size for Bamboo Specs detection to be modified.

    • ARTIFACT_COMPRESSION_DARK_FEATURE

      public static final SystemProperty ARTIFACT_COMPRESSION_DARK_FEATURE
      Makes artifacts and logs compression tied to the global compression configuration.

    • ROTP_DARK_FEATURE

      public static final SystemProperty ROTP_DARK_FEATURE
      Turns on the ROTP header and related stuff

    • ROTP_PROJECT_SHORTCUTS_DARK_FEATURE

      public static final SystemProperty ROTP_PROJECT_SHORTCUTS_DARK_FEATURE
      Turns on the ROTP project shortcuts

    • ROTP_ADMIN_SHORTCUTS_DARK_FEATURE

      public static final SystemProperty ROTP_ADMIN_SHORTCUTS_DARK_FEATURE
      Turns on the ROTP admin shortcuts

    • PDL_DARK_FEATURE

      public static final SystemProperty PDL_DARK_FEATURE
      Turns on the PDL and related stuff

    • ARTIFACT_SIZE_LIMIT_PER_BUILD

      public static final SystemProperty ARTIFACT_SIZE_LIMIT_PER_BUILD

    • DISABLE_BRANCH_DETECTION

      public static final SystemProperty DISABLE_BRANCH_DETECTION

    • DISABLE_TAG_DETECTION

      public static final SystemProperty.BooleanSystemProperty DISABLE_TAG_DETECTION

    • DISABLE_CLOSED_BRANCH_DETECTION

      public static final SystemProperty DISABLE_CLOSED_BRANCH_DETECTION

    • ATLASSIAN_DEV_MODE

      public static final SystemProperty ATLASSIAN_DEV_MODE

    • BAMBOO_REQUEST_PROFILING

      public static final SystemProperty BAMBOO_REQUEST_PROFILING

    • ALLOW_MUTATIVE_GET_IN_STRICT_XSRF_MODE

      public static final SystemProperty.BooleanSystemProperty ALLOW_MUTATIVE_GET_IN_STRICT_XSRF_MODE

    • BAMBOO_MANAGED_JMS_SSL

      public static final SystemProperty.BooleanSystemProperty BAMBOO_MANAGED_JMS_SSL
      Whether Bamboo manages SSL keys and certificates in JMS. If value is not defined or set to false, then Bamboo check if javax.net.ssl.keyStore property is set. When it's not set, then SSL keys and certificates management is enabled

      • Default : false
      • Usage:
        • env : bamboo.manage.jms.ssl=true
        • java: -Dbamboo.manage.jms.ssl=true

    • BAMBOO_JMS_SSL_CIPHER

      public static final SystemProperty BAMBOO_JMS_SSL_CIPHER
      Cipher class used for SSL keystore/truststore password decryption.

      • Default : com.atlassian.secrets.store.base64.Base64SecretStore
      • Usage:
        • env : bamboo.jms.ssl.cipher=com.atlassian.secrets.store.algorithm.AlgorithmSecretStore
        • java: -Dbamboo.jms.ssl.cipher=com.atlassian.secrets.store.algorithm.AlgorithmSecretStore

    • BAMBOO_JMS_SSL_KEYSTORE

      public static final SystemProperty BAMBOO_JMS_SSL_KEYSTORE
      Path to SSL keys keystore file used for SSL connector for JMS (agent-server communication).

      • Default : empty
      • Usage:
        • env : bamboo.jms.ssl.keyStore=/opt/atlassian/bamboo/secure/keystore.ks
        • java: -Dbamboo.jms.ssl.keyStore=/opt/atlassian/bamboo/secure/keystore.ks

    • BAMBOO_JMS_SSL_KEYSTORE_PASSWORD

      public static final SystemProperty BAMBOO_JMS_SSL_KEYSTORE_PASSWORD
      Encrypted Keystore password to BAMBOO_JMS_SSL_KEYSTORE file. See instructions at ...

      • Default : empty
      • Usage:
        • env : bamboo.jms.ssl.keyStorePassword=YmFtYm9v
        • java: -Dbamboo.jms.ssl.keyStorePassword=YmFtYm9v

    • BAMBOO_JMS_SSL_TRUSTSTORE

      public static final SystemProperty BAMBOO_JMS_SSL_TRUSTSTORE
      Path to SSL certificate truststore file used for SSL connector for JMS (agent-server communication).

      • Default : empty
      • Usage:
        • env : bamboo.jms.ssl.trustStore=/opt/atlassian/bamboo-agent/configuration/truststore.ts
        • java: -Dbamboo.jms.ssl.trustStore=/opt/atlassian/bamboo-agent/configuration/truststore.ts

    • BAMBOO_JMS_SSL_TRUSTSTORE_PASSWORD

      public static final SystemProperty BAMBOO_JMS_SSL_TRUSTSTORE_PASSWORD
      Encrypted Truststore password to BAMBOO_JMS_SSL_TRUSTSTORE file. See instructions at ...

      • Default : empty
      • Usage:
        • env : bamboo.jms.ssl.trustStorePassword=YmFtYm9v
        • java: -Dbamboo.jms.ssl.trustStorePassword=YmFtYm9v

    • EXPORT_WAIT_FOR_SERVER_PAUSE_SLEEP

      public static final SystemProperty.IntegerSystemProperty EXPORT_WAIT_FOR_SERVER_PAUSE_SLEEP
      Period between checks of the Server state when export is waiting for the server to pause.

      • Default : true
      • Usage:
        • env : bamboo.export.wait.for.server.pause.sleep=60000
        • java: -Dbamboo.export.wait.for.server.pause.sleep=60000

    • EXPORT_WAIT_FOR_SERVER_PAUSE_TIMEOUT

      public static final SystemProperty.IntegerSystemProperty EXPORT_WAIT_FOR_SERVER_PAUSE_TIMEOUT
      Timeout period to wait for running jobs to all be paused before running an export.

      • Default : true
      • Usage:
        • env : bamboo.export.wait.for.server.pause.timeout=3600000
        • java: -Dbamboo.export.wait.for.server.pause.timeout=3600000

    • EC2_AGENT_ENDPOINT

      public static final SystemProperty EC2_AGENT_ENDPOINT
      You can override the EC2 agent endpoint here, it will be used instead of the base URL. Unless you know what you're doing, you should use a localhost address of your Bamboo instance. Examples: http://localhost:8085, https://localhost:8085/bamboo, https://127.0.0.1:8085

    • CUSTOM_S3_ASSEMBLY_BUCKET

      public static final SystemProperty CUSTOM_S3_ASSEMBLY_BUCKET
      You can override the bucket used for EC2 agent bootstrap using this variable. Can be used in GovCloud/China regions and if your installation has a lot of plugins to download.

    • FILE_UPLOAD_MAXIMUM_SIZE

      public static final SystemProperty FILE_UPLOAD_MAXIMUM_SIZE
      Maximum size of uploaded files in megabytes
      • Default : true
      • env : bamboo.file.upload.max.size=50
      • java: -Dbamboo.file.upload.max.size=50

    • FUSION_DEPLOYMENTS_SUPPORT_DISABLED

      public static final SystemProperty.BooleanSystemProperty FUSION_DEPLOYMENTS_SUPPORT_DISABLED
      Disable sending any Deployments data to Fusion plugin. Do not use that property directly, use FeatureManager.isFusionDeploymentsSupportEnabled() to check its value.

    • REMOVE_LABELS_AND_PLANS_FOR_NON_PLAN_ADMIN

      public static final SystemProperty.BooleanSystemProperty REMOVE_LABELS_AND_PLANS_FOR_NON_PLAN_ADMIN
      Disable sending any Deployments data to Fusion plugin. Do not use that property directly, use FeatureManager.isFusionDeploymentsSupportEnabled() to check its value.

    • DISABLE_STASH_BUILD_STATUS_UPDATES

      public static final SystemProperty.BooleanSystemProperty DISABLE_STASH_BUILD_STATUS_UPDATES
      Globally disable sending build status updates to Stash after builds are executed. Do not use that property directly, use FeatureManager.isUpdatingStashWithBuildStatusEnabled() to check its value.

    • DISABLE_STASH_DEPLOYMENT_UPDATES

      public static final SystemProperty.BooleanSystemProperty DISABLE_STASH_DEPLOYMENT_UPDATES
      Globally disable sending deployment updates to Stash (Bitbucket Server) after deployments are executed. Do not use that property directly, use FeatureManager.isUpdatingStashWithDeploymentsEnabled() ()} to check its value.

    • DISABLE_STASH_EXTENDED_BUILD_STATUS_UPDATES

      public static final SystemProperty.BooleanSystemProperty DISABLE_STASH_EXTENDED_BUILD_STATUS_UPDATES
      Globally disable sending rich build status updates to Stash after builds are executed. Do not use that property directly, use FeatureManager.isUpdatingStashWithExtendedBuildStatusEnabled() to check its value.

    • ENFORCE_POLLING_BRANCH_DETECTION_EVEN_WHEN_REPO_CAN_PUSH_IT

      public static final SystemProperty.BooleanSystemProperty ENFORCE_POLLING_BRANCH_DETECTION_EVEN_WHEN_REPO_CAN_PUSH_IT

    • STASH_REPOSITORY_TRIGGER_POLLING_INTERVAL

      public static final SystemProperty.IntegerSystemProperty STASH_REPOSITORY_TRIGGER_POLLING_INTERVAL
      Polling interval (in seconds) for Stash trigger type.

      If this value is set to greater than 0 Stash triggers will poll the repository for changes in addition to listening for Stash events.

    • DISABLE_STASH_POLLING

      public static final SystemProperty.BooleanSystemProperty DISABLE_STASH_POLLING
      Completely disables polling BbS repositories for changes, even if applinks don't work or BbS plugin is disabled.

    • DISABLE_STASH_STATE_CHECK

      public static final SystemProperty.BooleanSystemProperty DISABLE_STASH_STATE_CHECK
      By default, before running any git operations, Bamboo contacts Stash to check whether its instance is available to handle requests. This property allows you to disable this check and proceed directly to the requested git operations.

      • Default : false
        • env : bamboo.disable.stash.state.check=true
        • java: -Dbamboo.disable.stash.state.check=true

    • CREATE_BITBUCKET_SSH_ALLOWLIST_RECORDS_AUTOMATICALLY

      public static final SystemProperty.BooleanSystemProperty CREATE_BITBUCKET_SSH_ALLOWLIST_RECORDS_AUTOMATICALLY
      If Bamboo should automatically create allowlist record for SSH endpoint of new Bitbucket Server application link.

      • Default : true
        • env : bamboo.stash.create.ssh.allow.list.records.automatically=false
        • java: -Dbamboo.stash.create.ssh.allow.list.records.automatically=false

    • AGENT_QUEUE_OFFLOADING_ENABLED

      public static final SystemProperty.BooleanSystemProperty AGENT_QUEUE_OFFLOADING_ENABLED
      Enables offloading of agent queue to disk. Use when agents OOM due to the amount of logging/slow link.

    • EPHEMERAL_AGENTS_LAUNCH_RETRIES_NUMBER

      public static final SystemProperty.IntegerSystemProperty EPHEMERAL_AGENTS_LAUNCH_RETRIES_NUMBER
      The default number of retries that are going to be performed in case of the ephemeral agent launch failure. The number of retries might be higher if there are more templates that can be used for pod launch than the specified value here. If the value is smaller or equal to 0, the rescheduler will be disabled completely, regardless of the number of applicable templates.

      • Default : 9
      • Usage:
        • env : bamboo.agent.ephemeral.launch.retries=3
        • java: -Dbamboo.agent.ephemeral.launch.retries=3

    • EPHEMERAL_AGENTS_LAUNCH_RETRIES_QUEUE_SIZE

      public static final SystemProperty.IntegerSystemProperty EPHEMERAL_AGENTS_LAUNCH_RETRIES_QUEUE_SIZE
      The size of the queue failed ephemeral agents' launch requests sit in.

      • Default : 1000
      • Usage:
        • env : bamboo.agent.ephemeral.launch.retries.queue.size=100
        • java: -Dbamboo.agent.ephemeral.launch.retries.queue.size=100

    • EPHEMERAL_AGENTS_LAUNCH_RETRIES_INITIAL_DELAY

      public static final SystemProperty.IntegerSystemProperty EPHEMERAL_AGENTS_LAUNCH_RETRIES_INITIAL_DELAY
      The initial delay in seconds after which the first scan of the failed ephemeral agents' launch queue will be made.

      • Default : 60
      • Usage:
        • env : bamboo.agent.ephemeral.launch.retries.initial.delay=120
        • java: -Dbamboo.agent.ephemeral.launch.retries.initial.delay=120

    • EPHEMERAL_AGENTS_LAUNCH_RETRIES_DELAY

      public static final SystemProperty.IntegerSystemProperty EPHEMERAL_AGENTS_LAUNCH_RETRIES_DELAY
      The delay in seconds between two calls of the failed ephemeral agents' launch queue scan.

      • Default : 10
      • Usage:
        • env : bamboo.agent.ephemeral.launch.retries.delay=60
        • java: -Dbamboo.agent.ephemeral.launch.retries.delay=60

    • EPHEMERAL_AGENTS_LOG_SIZE

      public static final SystemProperty.IntegerSystemProperty EPHEMERAL_AGENTS_LOG_SIZE
      The number of ephemeral agents related logs kept for displaying on the pods' management UI.

      • Default : 40
      • Usage:
        • env : bamboo.agent.ephemeral.log.size=60
        • java: -Dbamboo.agent.ephemeral.log.size=60

    • EPHEMERAL_POD_DELETION_BATCH_SIZE

      public static final SystemProperty.IntegerSystemProperty EPHEMERAL_POD_DELETION_BATCH_SIZE
      The number of pods with inactive bamboo-agent container being deleted in one batch.

      • Default : 5
      • Usage:
        • env : bamboo.agent.ephemeral.deletion.batch.size=5
        • java: -Dbamboo.agent.ephemeral.deletion.batch.size=5

    • EPHEMERAL_KUBERNETES_EXECUTION_TIMEOUT

      public static final SystemProperty.IntegerSystemProperty EPHEMERAL_KUBERNETES_EXECUTION_TIMEOUT
      The execution timeout of ephemeral agents' Kubernetes cluster related commands in seconds.

      • Default : 60
      • Usage:
        • env : bamboo.agent.ephemeral.kubernetes.execution.timeout=120
        • java: -Dbamboo.agent.ephemeral.kubernetes.execution.timeout=120

    • EPHEMERAL_KUBERNETES_IDLE_TIMEOUT

      public static final SystemProperty.IntegerSystemProperty EPHEMERAL_KUBERNETES_IDLE_TIMEOUT
      The idle timeout of ephemeral agents' Kubernetes cluster related commands in seconds.

      • Default : 60
      • Usage:
        • env : bamboo.agent.ephemeral.kubernetes.idle.timeout=120
        • java: -Dbamboo.agent.ephemeral.kubernetes.idle.timeout=120

    • ENABLE_REMOTE_AGENTS_SHELL

      public static final SystemProperty.BooleanSystemProperty ENABLE_REMOTE_AGENTS_SHELL
      When enabled, users with appropriate permissions can access agents through a terminal integrated with Bamboo.

    • SKIP_BOOT_DELEGATION_OVERRIDES

      public static final SystemProperty.BooleanSystemProperty SKIP_BOOT_DELEGATION_OVERRIDES
      When enabled, skips performing boot delegation workarounds on Bamboo startup

    • ENABLE_XML_FACTORY_OVERRIDE

      public static final SystemProperty.BooleanSystemProperty ENABLE_XML_FACTORY_OVERRIDE
      When enabled, enables applying the system XML parser workaround (BDEV-7924)

    • MAX_CONCURRENT_EXPENSIVE_MESSAGES

      public static final SystemProperty.IntegerSystemProperty MAX_CONCURRENT_EXPENSIVE_MESSAGES
      Configure maximum number of threads to handle expensive messages concurrently.

    • BRANCH_EXPIRY_SCHEDULED_TIME

      public static final SystemProperty BRANCH_EXPIRY_SCHEDULED_TIME
      Configure at what time should branch expiry run. Value should represent a valid time and is parsed using DateTimeFormatter.ISO_LOCAL_TIME

      Usage: 

      -Dbamboo.branch.expiry.schedule="04:56"

    • BAMBOO_BUILD_EXPIRY_BATCH_SIZE

      public static final SystemProperty.IntegerSystemProperty BAMBOO_BUILD_EXPIRY_BATCH_SIZE
      Configure how many results should be processed by build expiry service at each run. Setting it to 0 or less is equivalent to turning build expiry service off.

      • Default : 500
        • env : bamboo.build.expiry.batch.size=500
        • java: -Dbamboo.build.expiry.batch.size=500

    • BAMBOO_BUILD_EXPIRY_BATCH_INTERVAL_MILLISECONDS

      public static final SystemProperty.IntegerSystemProperty BAMBOO_BUILD_EXPIRY_BATCH_INTERVAL_MILLISECONDS
      Configure an interval between batches while processing build results in build expiry service. Setting it to 0 or less turns it off. It is useful to prevent starvation due to high volume of build results being processed.

      • Default : 0
        • env : bamboo.build.expiry.batch.interval.milliseconds=100
        • java: -Dbamboo.build.expiry.batch.interval.milliseconds=100

    • BAMBOO_BUILD_EXPIRY_TRANSACTION_TIME_LIMIT_SECONDS

      public static final SystemProperty.IntegerSystemProperty BAMBOO_BUILD_EXPIRY_TRANSACTION_TIME_LIMIT_SECONDS
      Configure a time limit for a transaction to remain open during the build expiry process. Setting it to 0 turns it off, i.e., the transaction will remain open until the whole batch is processed.

      Each build result batch is processed in the same transaction up to the point where it processes the whole batch or when the time limit defined by this property is exceeded. When either of these situations happen, the database session is flushed.

      Important to note that this time limit is checked after processing each build result. In other words, the session will be flushed AFTER finishing to process the first build result that makes the overall time to exceed the limit and not immediately after the time limit was reached. E.g.: If the time limit is defined as 2 seconds and the first build result took 5 seconds to be processed, then the session remained open for 5 seconds and not 2.

      • Default : 1800 (30 minutes)
        • env : bamboo.build.expiry.transaction.time.limit.seconds=600
        • java: -Dbamboo.build.expiry.transaction.time.limit.seconds=600

    • PERSIST_RUNTIME_STATE

      public static final SystemProperty.BooleanSystemProperty PERSIST_RUNTIME_STATE
      Whether Bamboo should persist/restore runtime operations: builds and deployments in progress. Use this flag to turn off seamless restart feature completely.

      • Default : true
      • Usage:
        • env : bamboo.darkfeature.persist.runtime.state=true
        • java: -Dbamboo.darkfeature.persist.runtime.state="true"

    • BAMBOO_IGNORE_SERVER_STATE_ON_RESTART

      public static final SystemProperty.BooleanSystemProperty BAMBOO_IGNORE_SERVER_STATE_ON_RESTART
      Disables seamless restart feature. Does not disable state persistence. Can be used to force non-seamless restart of the server, without affecting ability to use make subsequent restart seamless.

      • Default : false
      • Usage:
        • env : bamboo.ignore.server.state.on.restart=true
        • java: -Dbamboo.ignore.server.state.on.restart=true

    • BROKER_KAHA_PREALLOCATION_STRATEGY

      public static final SystemProperty BROKER_KAHA_PREALLOCATION_STRATEGY
      This setting configures how the broker will try to preallocate the journal files when a new journal file is needed. `sparse_file` - sets the file length, but does not populate it with any data. `os_kernel_copy` - delegates the preallocation to the Operating System. `zeros` - each preallocated journal file contains nothing but 0x00 throughout. Learn more

      • Default : zeros
      • Usage:
        • env : bamboo.broker.kaha.preallocationStrategy=sparse_file
        • java: -Dbamboo.broker.kaha.preallocationStrategy=sparse_file
      Since:
      9.5

    • BROKER_KAHA_JOURNAL_DISK_SYNC_STRATEGY

      public static final SystemProperty BROKER_KAHA_JOURNAL_DISK_SYNC_STRATEGY
      This setting configures the disk sync policy. The list of available sync strategies are (in order of decreasing safety, and increasing performance): `always` Ensure every journal write is followed by a disk sync (JMS durability requirement). This is the safest option but is also the slowest because it requires a sync after every message write. `periodic` The disk will be synced at set intervals (if a write has occurred) instead of after every journal write which will reduce the load on the disk and should improve throughput. The disk will also be synced when rolling over to a new journal file. The interval is 1 second. The default interval offers very good performance, whilst being safer than `never` disk syncing, as data loss is limited to a maximum of 1 second’s worth. `never` A sync will never be explicitly called and it will be up to the operating system to flush to disk. This is the fastest option but is the least safe as there’s no guarantee as to when data is flushed to disk. Consequently message loss can occur on broker failure. Learn more

      • Default : always
      • Usage:
        • env : bamboo.broker.kaha.journalDiskSyncStrategy=periodic
        • java: -Dbamboo.broker.kaha.journalDiskSyncStrategy=periodic
      Since:
      9.5

    • BAMBOO_ACTIVE_MQ_MEMORY_USAGE_LIMIT_MB

      public static final SystemProperty.IntegerSystemProperty BAMBOO_ACTIVE_MQ_MEMORY_USAGE_LIMIT_MB
      Lets you configure the maximum memory usage of ActiveMQ in MB.

      • Default : 512
      • Usage:
        • env : bamboo.active.mq.memory.usage.limit.mb=1024
        • java: -Dbamboo.active.mq.memory.usage.limit.mb=1024

    • GLOBAL_REPOSITORY_DASHBOARD

      public static final SystemProperty.BooleanSystemProperty GLOBAL_REPOSITORY_DASHBOARD
      Whether Bamboo should show new (true) or old (false) global repository ui.

    • DISABLE_MAIN_DASHBOARD_OPTIMIZATION

      public static final SystemProperty.BooleanSystemProperty DISABLE_MAIN_DASHBOARD_OPTIMIZATION
      Whether Bamboo should skip optimization in fetching the main dashboard.

    • MAIL_QUEUE_SIZE

      public static final SystemProperty.IntegerSystemProperty MAIL_QUEUE_SIZE
      Size of Bamboo's mail queue

      • Default : 1000
      • Usage:
        • env : bamboo.mail.queue.size=1000
        • java: -Dbamboo.mail.queue.size=1000

    • GRAVATAR_BASE_URL

      public static final SystemProperty GRAVATAR_BASE_URL
      Base url for Atlassian account avatars. In case of Atlassian account enabled it's used as a Gravatar base url

    • PLAN_DIRECTORY_INFO_REST

      public static final SystemProperty PLAN_DIRECTORY_INFO_REST
      Enable REST resource to get information about the directories where artifacts, build logs, and build results will be stored. Possible values: - local - only requests from localhost will be served - anonymous - feature is enabled for all requests - authenticated - feature is enabled only for authenticated users - authenticated-admin - feature is enabled only for instance administrators

    • BAMBOO_INSTANCE_SPECIFIC_DATA_LOCATIONS

      public static final SystemProperty BAMBOO_INSTANCE_SPECIFIC_DATA_LOCATIONS

    • GIT_PASSWORD_USE_CREDENTIALS_FILE

      public static final SystemProperty.BooleanSystemProperty GIT_PASSWORD_USE_CREDENTIALS_FILE
      Whether Bamboo should use credentials file during https/http connection to git repository with user/password authentication Use this flag to disable the feature and fallback to old credentials via url method.

      • Default: true
      • Usage:
        • env : bamboo.git.password.use.credentials.file=false
        • java: -Dbamboo.git.password.use.credentials.file="false"

    • ELASTIC_AGENT_INSTANCE_NAME

      public static final SystemProperty ELASTIC_AGENT_INSTANCE_NAME
      Property set on elastic agent that denotes the agent's name to use. When used, Bamboo will set the AWS Name tag for the instance to the name specified. Otherwise it falls back to a default pattern of hostname and username.

    • CRYPTO_TRUST_SVN_SSH_ALL

      public static final SystemProperty.BooleanSystemProperty CRYPTO_TRUST_SVN_SSH_ALL
      Whether Bamboo should accept unknown host keys during ssh connection to SVN repository with private key Use this flag to disable server ssh key validation.

      • Default: false
      • Usage:
        • env : bamboo.crypto.trust.svn.ssh.all=true
        • java: -Dbamboo.crypto.trust.svn.ssh.all="true"

    • DISABLE_SERIALIZATION_SECURITY

      public static final SystemProperty.BooleanSystemProperty DISABLE_SERIALIZATION_SECURITY
      Whether Bamboo should disable serialization security feature. It will turn off validation of classes serialized with XStream by Allow or Block lists

      • Default : false
        • env : bamboo.security.serialization.disable=true
        • java: -Dbamboo.security.serialization.disable=true

    • MAX_PENDING_TEST_CASE_EVICTIONS

      public static final SystemProperty.IntegerSystemProperty MAX_PENDING_TEST_CASE_EVICTIONS
      How often do the test cases get evicted during test parsing. Increase if you're getting OOMs during test parsing. Currently only works for newly discovered tests.

    • ORPHANED_TEST_CASE_CRON_SCHEDULE

      public static final SystemProperty ORPHANED_TEST_CASE_CRON_SCHEDULE
      Cron expression to schedule orphaned test case removal job. Default value is "0 0 0 ? * SUN *"

    • ORPHANED_BUILD_MONITOR_JOB_SCHEDULER_REACTION_DELAY_MULTIPLIER

      public static SystemProperty ORPHANED_BUILD_MONITOR_JOB_SCHEDULER_REACTION_DELAY_MULTIPLIER
      Specifies the multiplier factor of the orphaned build monitor job's reaction delay. The formula for the reaction delay is heartbeatTimeoutSeconds + X * heartbeatInterval, where X is the multiplier. The allowed values are between 1 and 20. The default value is 2.

      • Default : false
        • env : bamboo.orphaned.build.monitor.reaction.delay.multiplier=3
        • java: -Dbamboo.orphaned.build.monitor.reaction.delay.multiplier=3

    • SKIP_MSSQL_CONFIG_VALIDATION

      public static final SystemProperty.BooleanSystemProperty SKIP_MSSQL_CONFIG_VALIDATION
      Turns off MS SQL configuration check.

    • DISABLE_ALL_DARK_FEATURES

      public static final SystemProperty.BooleanSystemProperty DISABLE_ALL_DARK_FEATURES
      System property to disable all dark features in Bamboo. Works with DarkFeatureManager and DarkFeatureService. Will not work for custom system properties used as dark features.

    • ALLOW_URL_PARAMETERS_LOGIN

      public static final SystemProperty.BooleanSystemProperty ALLOW_URL_PARAMETERS_LOGIN
      Whether logging in by passing URL parameters (os_username/os_password) is enabled.
      See Also:
      • LoginFilter

    • DISABLE_ENCRYPTION

      public static final SystemProperty.BooleanSystemProperty DISABLE_ENCRYPTION
      Whether secret encryption logic should be skipped. Use with caution only for dev needs. For example to work with DB backups which don't include file-system part of cypher.

    • IGNORE_DECRYPTION_ERRORS

      public static final SystemProperty.BooleanSystemProperty IGNORE_DECRYPTION_ERRORS
      Whether secret decryption should tolerate errors. Use with caution only for support needs, e.g to work with DB backups which have values encrypted by unavailable cyphers.

    • REPOSITORY_STORED_SPECS_TIMEOUT_SECONDS

      public static final SystemProperty.IntegerSystemProperty REPOSITORY_STORED_SPECS_TIMEOUT_SECONDS
      Set the timeout on commands executed in the repository stored specs feature

    • REPOSITORY_STORED_SPECS_THREADS

      public static final SystemProperty.IntegerSystemProperty REPOSITORY_STORED_SPECS_THREADS
      Set the amount of parallel threads processing independent specs updates

    • REPOSITORY_STORED_SPECS_SECURITY_MANAGER_ENABLED

      public static final SystemProperty.BooleanSystemProperty REPOSITORY_STORED_SPECS_SECURITY_MANAGER_ENABLED
      Controls use of security manager during Specs processing (enabled by default)
      Since:
      6.3

    • REPOSITORY_STORED_SPECS_POM_SANITIZATION_ENABLED

      public static final SystemProperty.BooleanSystemProperty REPOSITORY_STORED_SPECS_POM_SANITIZATION_ENABLED
      Controls POM sanitization during Specs processing (enabled by default)
      Since:
      6.3

    • REPOSITORY_STORED_SPECS_MAVEN_COMPILER_VERSION

      public static final SystemProperty REPOSITORY_STORED_SPECS_MAVEN_COMPILER_VERSION
      Controls Maven javac source and target version used during Specs processing

      • Default : The major version from the earliest supported Java version of each Bamboo release
      • E.g.: 1.8, 11, 17, etc
        • env : bamboo.repository.stored.specs.maven.compiler.version=11
        • java: -Dbamboo.repository.stored.specs.maven.compiler.version=11

      Since:
      10.2

    • CLEAN_TEMP_AT_START_ENABLED

      public static final SystemProperty.BooleanSystemProperty CLEAN_TEMP_AT_START_ENABLED
      Cleaning temp dir on bamboo startup (disabled by default)

      • Default : false
      • Usage:
        • env : bamboo.clean.temp.enabled=true
        • java: -Dbamboo.clean.temp.enabled=true
      Since:
      7.2.5, 8.0

    • CHANGE_DETECTION_CACHE_TTL_SECONDS

      public static final SystemProperty.IntegerSystemProperty CHANGE_DETECTION_CACHE_TTL_SECONDS
      Sets the change detection cache TTL in seconds. Increase to reduce the amount of polling done against your VCS. Only supported for Git-based repos. The default value is 15 seconds.

    • PULL_REQUEST_DETECTION_THREAD_COUNT

      public static final SystemProperty.IntegerSystemProperty PULL_REQUEST_DETECTION_THREAD_COUNT
      Size of thread pool for pull request detection. Default value is 3

    • ORPHANED_PULL_REQUESTS_CLEANUP_SCHEDULE

      public static final SystemProperty ORPHANED_PULL_REQUESTS_CLEANUP_SCHEDULE
      Cron expression to schedule orphaned pull requests removal job. Default value is "0 0 0 7,17,27 * ?"

    • ORPHANED_PULL_REQUEST_INACTIVITY_DAYS

      public static final SystemProperty.IntegerSystemProperty ORPHANED_PULL_REQUEST_INACTIVITY_DAYS
      Number of days between last pull request modification and 'now' before pull requests will be deleted. Default value is 7

    • PULL_REQUEST_POLLING_INTERVAL

      public static final SystemProperty.IntegerSystemProperty PULL_REQUEST_POLLING_INTERVAL
      Interval between polling for open PRs in seconds. Used for repositories which require PR polling (like Bitbucket Cloud). Default value is 0, in such case Branch detection interval from administration.xml is used.

    • PULL_REQUEST_CACHE_TTL

      public static final SystemProperty.IntegerSystemProperty PULL_REQUEST_CACHE_TTL
      Sets the pull request detection cache TTL in seconds. Increase to reduce the amount of polling done against your VCS. The default value is 60 seconds.

    • JUNIT_PARSER_IGNORE_NAMED_INNER_CLASSES

      public static final SystemProperty.BooleanSystemProperty JUNIT_PARSER_IGNORE_NAMED_INNER_CLASSES
      Set if named inner classes should be ignored as individual test entities during junit report parsing. Default value is false. Use this property if you need behavior Bamboo used before fix of https://jira.atlassian.com/browse/BAM-10153
      Since:
      6.1.0

    • DEFAULT_TIMEOUT_FOR_HTTP_CLIENT

      public static final SystemProperty.IntegerSystemProperty DEFAULT_TIMEOUT_FOR_HTTP_CLIENT
      Default timeout for com.atlassian.bamboo.rest.utils.RESTCall#getHttpClientWithTimeout() Timeout is defined in milliseconds. Default value is 5000 (5s).
      Since:
      6.2.0

    • DISABLE_X_CONTENT_TYPE_OPTIONS_NOSNIFF

      @Deprecated public static final SystemProperty.BooleanSystemProperty DISABLE_X_CONTENT_TYPE_OPTIONS_NOSNIFF
      Deprecated.
      Disable adding 'X-Content-Type-Options: nosniff' to all pages served by Bamboo.
      Since:
      10.0.2 use HTTP_HEADER_SECURITY_X_CONTENT_TYPE_OPTIONS_NOSNIFF_DISABLED

    • TEXT_PLAIN_MIME_DEFAULT_ENCODING

      public static final SystemProperty TEXT_PLAIN_MIME_DEFAULT_ENCODING
      MIME encoding for text/plain resources defined in mimetypes.xml. In case of different encodings for different file extensions with text/plain type value of encoding should be defined at mimetypes.xml. In that case Bamboo will not append default encoding. Default value is 'UTF-8'.

    • SKIP_DB_VERSION_CHECKS

      public static final SystemProperty.BooleanSystemProperty SKIP_DB_VERSION_CHECKS
      Whether Bamboo should skip DB checks

      • Default : false
        • env : bamboo.skip.db.version.checks=true
        • java: -Dbamboo.skip.db.version.checks=true

    • CHECK_MYSQL_VER_ON_UPGRADE

      public static final SystemProperty.BooleanSystemProperty CHECK_MYSQL_VER_ON_UPGRADE
      Whether Bamboo should fail on upgrade when version of Mysql is not supported

      • Default : true
        • env : bamboo.upgrade.fail.if.mysql.unsupported=false
        • java: -Dbamboo.upgrade.fail.if.mysql.unsupported=false

    • CHECK_JAVA_VERSION_ON_UPGRADE

      public static final SystemProperty.BooleanSystemProperty CHECK_JAVA_VERSION_ON_UPGRADE
      Whether Bamboo should fail on upgrade when version of Java is not supported

      • Default : true
        • env : bamboo.upgrade.fail.if.java.unsupported=false
        • java: -Dbamboo.upgrade.fail.if.java.unsupported=false

    • SETUP_RSS_IN_DOCKER

      public static final SystemProperty.BooleanSystemProperty SETUP_RSS_IN_DOCKER
      Used during Bamboo setup phase. Has no effect afterwards. Can be used to disable processing of Repository-stored Specs in a Docker container. Useful i.a. when the Bamboo server is being set up in a Docker container itself.

    • SKIP_RSS_OPTIMISATION

      public static final SystemProperty.BooleanSystemProperty SKIP_RSS_OPTIMISATION
      Normally, Bamboo will skip RSS processing for plans without changes. If you enable this setting, all entities in RSS will always be updated.

    • DOCKER_PIPELINES_DISABLED

      public static final SystemProperty.BooleanSystemProperty DOCKER_PIPELINES_DISABLED
      Whether Docker Pipelines functionality is disabled. Default is false.

    • RSS_COMMIT_LEVEL_COMMENT_DISABLED

      public static final SystemProperty.BooleanSystemProperty RSS_COMMIT_LEVEL_COMMENT_DISABLED
      Whether Repository Stored Specs execution status comment at repository commit level is disabled. Default is false.

    • LOGS_AS_ARTIFACTS_ENABLED

      public static final SystemProperty.BooleanSystemProperty LOGS_AS_ARTIFACTS_ENABLED
      Whether the logs should be transferred like artifacts at the end of the build

    • VARIABLE_UPGRADE_SCHEDULE_CRON

      public static final SystemProperty VARIABLE_UPGRADE_SCHEDULE_CRON
      Configure at what time variable upgrade should run. Value should represent a valid Quartz cron expression

      Usage: 

      -Dbamboo.variable.upgrade.schedule="0 0 4 ? * *"
      (fire at 4am every day) 

      -Dbamboo.variable.upgrade.schedule="0 0 * ? * *"
      (run every hour)

      More examples: @see <a href="http://www.quartz-scheduler.org/documentation/quartz-2.x/tutorials/crontrigger.html>Quartz tutorial

    • VARIABLE_UPGRADE_DEFAULT_BATCH_SIZE

      public static final int VARIABLE_UPGRADE_DEFAULT_BATCH_SIZE
      See Also:

    • VARIABLE_UPGRADE_BATCH_SIZE

      public static final SystemProperty.IntegerSystemProperty VARIABLE_UPGRADE_BATCH_SIZE
      Configure how many results should be processed at each run of variable upgrade. Setting this to 0 or less turns off the upgrade.

    • BUILD_WARNINGS_MAXIMUM_COUNT_PER_BUILD

      public static final SystemProperty.IntegerSystemProperty BUILD_WARNINGS_MAXIMUM_COUNT_PER_BUILD
      Configure maximum number of warnings stored per build. This affects content of the warning artifact; skipped warnings are still counted in summary. If less than 0 then the number is unlimited.

    • BUILD_WARNINGS_THREAD_COUNT

      public static final SystemProperty.IntegerSystemProperty BUILD_WARNINGS_THREAD_COUNT
      Configure number of threads which will send build warnings to external servers.

    • BUILD_WARNINGS_QUEUE_MAX_SIZE

      public static final SystemProperty.IntegerSystemProperty BUILD_WARNINGS_QUEUE_MAX_SIZE
      Configure max size of build warnings in queue waiting to be sent to remote repositories. Default value is 200.

    • RSS_POLLING_ENABLED

      public static final SystemProperty.BooleanSystemProperty RSS_POLLING_ENABLED
      Switch RSS polling on.

    • CROWD_DELETED_ENTITY_LISTENER_THREADS

      public static final SystemProperty.IntegerSystemProperty CROWD_DELETED_ENTITY_LISTENER_THREADS
      Number of threads used to process entity deletion events from Embedded Crowd. Defaults to 2 threads.

    • CROWD_DELETED_ENTITY_TIMEOUT_DAYS

      public static final SystemProperty.IntegerSystemProperty CROWD_DELETED_ENTITY_TIMEOUT_DAYS
      Number of days after which cleanup of deleted Crowd entities will swipe away all remaining user/group data from Bamboo. Defaults to 7 days.

    • CROWD_DELETED_ENTITY_CLEANUP_HOUR

      public static final SystemProperty.IntegerSystemProperty CROWD_DELETED_ENTITY_CLEANUP_HOUR
      Hour (in 24h format, from 0 to 23) at which a daily cleanup of deleted Crowd entities is run. Defaults to 4 am.

    • PERFORMANCE_DATA_GATHERING_ENABLED

      public static final SystemProperty.BooleanSystemProperty PERFORMANCE_DATA_GATHERING_ENABLED
      Allows this Bamboo instance to measure performance data and to send it anonymously as statistical data to Atlassian. Defaults to true.

    • PERFORMANCE_DATA_TEST_GATHERING_ENABLED

      public static final SystemProperty.BooleanSystemProperty PERFORMANCE_DATA_TEST_GATHERING_ENABLED
      Allows this Bamboo instance to measure performance data even if analytics are disabled. Defaults to false.

    • PERFORMANCE_DATA_DISPATCH_HOUR

      public static final SystemProperty.IntegerSystemProperty PERFORMANCE_DATA_DISPATCH_HOUR
      Hour (in 24h format, from 0 to 23) at which daily summary of performance is sent via Analytics. Defaults to 2 am.

    • STALE_AVATARS_REMOVAL_HOUR

      public static final SystemProperty.IntegerSystemProperty STALE_AVATARS_REMOVAL_HOUR
      Hour (in 24-hour format, from 0 to 23) at which daily stale avatars are cleared out (for example, avatars of users that don't exist any longer). Defaults to 5 am.

    • SSH_PROXY_CLIENT_AUTH_TIMEOUT

      public static final SystemProperty.IntegerSystemProperty SSH_PROXY_CLIENT_AUTH_TIMEOUT
      Authentication timeout for SSH proxy which Bamboo starts to fetch data for some repositories, e.g. Git. In minutes Value is not propagated to remote or elastic agents and should be set at wrapper.conf file.

      • Default : 2
        • env : bamboo.ssh.proxy.client.auth.timeout=1
        • java: -Dbamboo.ssh.proxy.client.auth.timeout=1

    • SSH_PROXY_CLIENT_IDLE_TIMEOUT

      public static final SystemProperty.IntegerSystemProperty SSH_PROXY_CLIENT_IDLE_TIMEOUT
      Idle timeout for SSH Proxy Client which Bamboo uses to fetch data from Bamboo Proxy Server for some repositories, e.g. Git. In minutes. Might be used to solve issues with timeout errors when fetching large (> 50 Gb) repositories. Value is not propagated to remote or elastic agents and should be set at wrapper.conf file.

      • Default : 2
        • env : bamboo.ssh.proxy.client.idle.timeout=10
        • java: -Dbamboo.ssh.proxy.client.idle.timeout=10

    • SSH_PROXY_SERVER_IDLE_TIMEOUT

      public static final SystemProperty.IntegerSystemProperty SSH_PROXY_SERVER_IDLE_TIMEOUT
      Idle timeout for SSH Proxy Server which Bamboo starts to fetch data for some repositories, e.g. Git. In minutes. Might be used to solve issues with timeout errors when fetching large (> 50 Gb) repositories. Value is not propagated to remote or elastic agents and should be set at wrapper.conf file.

      • Default : 10
        • env : bamboo.ssh.proxy.server.idle.timeout=10
        • java: -Dbamboo.ssh.proxy.server.idle.timeout=10

    • SSH_PROXY_SERVER_READ_TIMEOUT

      public static final SystemProperty.IntegerSystemProperty SSH_PROXY_SERVER_READ_TIMEOUT
      Read timeout for SSH Proxy Server which Bamboo starts to fetch data for some repositories, e.g. Git. In minutes. Might be used to solve issues with timeout errors when fetching large (> 50 Gb) repositories. Value is not propagated to remote or elastic agents and should be set at wrapper.conf file.

      • Default : 11
        • env : bamboo.ssh.proxy.server.read.timeout=30
        • java: -Dbamboo.ssh.proxy.server.read.timeout=30

    • EC_UPGRADE_TEST_CONNECTION_ENABLED

      public static final SystemProperty.BooleanSystemProperty EC_UPGRADE_TEST_CONNECTION_ENABLED
      Enable connection testing during EC upgrade.

    • DISABLE_REMOTE_TRIGGER_PROXY_VALIDATION

      public static final SystemProperty.BooleanSystemProperty DISABLE_REMOTE_TRIGGER_PROXY_VALIDATION
      Disable validation of ips from X-FORWARDED-FOR headers when executing remote triggers (in other words, only request IP will be checked). This reduces security but makes configuration of the trigger easier. False by default.

    • SPECS_YAML_INCLUDE_MAX_DEPTH

      public static final SystemProperty.IntegerSystemProperty SPECS_YAML_INCLUDE_MAX_DEPTH
      Max depth of file inclusions in YAML Specs.

    • JMS_STORE_DIRECTORY

      public static final SystemProperty JMS_STORE_DIRECTORY
      Jms store directory. In case of property is not set ${bamboo.shared.home}/jms-store directory will be used.

    • MAX_TOKENS_PER_USER

      public static final SystemProperty.IntegerSystemProperty MAX_TOKENS_PER_USER
      Max number of personal access token per user. Default value is 100

    • DISABLE_RESULTS_CLEANUP_ON_STARTUP

      public static final SystemProperty.BooleanSystemProperty DISABLE_RESULTS_CLEANUP_ON_STARTUP
      Allows to completely disable builds results states cleanup on startup.

    • SPECS_FOR_BRANCHES_ENABLED

      public static final SystemProperty.BooleanSystemProperty SPECS_FOR_BRANCHES_ENABLED
      Enable divergent branches

    • NOTIFICATION_DISABLED

      public static final SystemProperty.BooleanSystemProperty NOTIFICATION_DISABLED
      Disable notifications sending by email / XMPP

    • SHOW_STACK_TRACES_ON_500

      public static final SystemProperty.BooleanSystemProperty SHOW_STACK_TRACES_ON_500
      Toggle showing exception stack traces on 500 error page Default: true

    • OSGI_SERVICE_INVOCATION_TIMEOUT

      public static final SystemProperty.IntegerSystemProperty OSGI_SERVICE_INVOCATION_TIMEOUT
      Set the OSGi Service Invocation Timeout in milliseconds Default: 10000ms, 10 seconds

    • ORPHANED_SPECS_STATES_CLEANUP_SCHEDULE

      public static final SystemProperty ORPHANED_SPECS_STATES_CLEANUP_SCHEDULE
      Cron expression to schedule orphaned Specs states removal job. Default value is "0 0 2 * * ?" (every day at 2am)

    • SPECS_MAX_ALIASES_FOR_COLLECTIONS

      public static final SystemProperty.IntegerSystemProperty SPECS_MAX_ALIASES_FOR_COLLECTIONS
      Configure count of anchor elements for generated Yaml file when Java Specs are being processed. Should be increased in case of error message in log "Number of aliases for non-scalar nodes exceeds the specified max=X".

      • Default : 1500
        • env : bamboo.specs.max.aliases.for.collections=100
        • java: -Dbamboo.specs.max.aliases.for.collections=100

    • SPECS_CODE_POINTS_LIMIT_PROPERTY

      public static final SystemProperty.IntegerSystemProperty SPECS_CODE_POINTS_LIMIT_PROPERTY
      Configure max length of accepted Yaml file when Java Specs are being processed. Should be increased in case of error message in log "The incoming YAML document exceeds the limit: X".

      • Default : 6291456
        • env : bamboo.specs.code.point.limit=7000000
        • java: -Dbamboo.specs.code.point.limit=7000000

    • GLOBAL_EXPORT_TO_SPECS_ENABLED

      public static final SystemProperty.BooleanSystemProperty GLOBAL_EXPORT_TO_SPECS_ENABLED
      If global 'export to specs' option should be visible in the ui.

    • REPOSITORY_STORED_SPECS_DETECTION_DISABLED

      public static SystemProperty.BooleanSystemProperty REPOSITORY_STORED_SPECS_DETECTION_DISABLED
      If repository stored specs detection should be disabled.

      • Default : false
        • env : bamboo.repository.stored.specs.detection.disabled=true
        • java: -Dbamboo.repository.stored.specs.detection.disabled=true

    • NATIVE_GIT_FOLDER_CLEARING_DISABLED

      public static final SystemProperty.BooleanSystemProperty NATIVE_GIT_FOLDER_CLEARING_DISABLED
      If git repositories should be cleared on operation retry (applies to native git only)

    • WEBHOOK_MAX_QUEUE_SIZE

      public static final SystemProperty.IntegerSystemProperty WEBHOOK_MAX_QUEUE_SIZE
      Size of Webhook's queue to send. Default is 1024.

    • WEBHOOK_TIMEOUT

      public static final SystemProperty.IntegerSystemProperty WEBHOOK_TIMEOUT
      Timeout for webhook calls in ms. Default is 10000ms (10s).

    • WEBHOOK_MAX_RETRIES

      public static final SystemProperty.IntegerSystemProperty WEBHOOK_MAX_RETRIES
      Max number or webhook send retries. Default is 3.

    • WEBHOOK_THREAD_COUNT

      public static final SystemProperty.IntegerSystemProperty WEBHOOK_THREAD_COUNT
      Size of thread pool for webhooks sending. Default value is 2

    • REMOTE_BROADCAST_DOWNTIME_INCREMENT_SECONDS

      public static final SystemProperty.IntegerSystemProperty REMOTE_BROADCAST_DOWNTIME_INCREMENT_SECONDS
      Configuring remote event broadcast back off on timeout exceptions: base length of 'quiet time' in seconds.

    • REMOTE_BROADCAST_DOWNTIME_MAX_MULTIPLIER

      public static final SystemProperty.IntegerSystemProperty REMOTE_BROADCAST_DOWNTIME_MAX_MULTIPLIER
      Configuring remote event broadcast back off on timeout exceptions: maximum broadcast break multiplier. If set to 0 the backing off is disabled.

    • REMOTE_AGENT_ASYNCH_DISPATCH_THREADPOOL_SIZE

      public static final SystemProperty.IntegerSystemProperty REMOTE_AGENT_ASYNCH_DISPATCH_THREADPOOL_SIZE
      If agent transport should use asynchronous dispatching. Disabled, if <=0, otherwise defines the thread pool size used for asynchronous dispatching. Default is 0.

    • IMPORT_REPORT_PROGRESS_STEP_PROPERTY

      public static final SystemProperty.IntegerSystemProperty IMPORT_REPORT_PROGRESS_STEP_PROPERTY
      How often should Bamboo display import progress

    • AUDIT_LOG_FOR_RSS_UPDATES_DISABLED

      public static final SystemProperty.BooleanSystemProperty AUDIT_LOG_FOR_RSS_UPDATES_DISABLED
      Whether audit logs are disabled for RSS updates.

      • Default : true
        • env : bamboo.rss.audit.logs.disabled=false
        • java: -Dbamboo.rss.audit.logs.disabled=false

    • NODE_ALIVE_WATCHDOG_ENABLED

      public static final SystemProperty.BooleanSystemProperty NODE_ALIVE_WATCHDOG_ENABLED
      Whether node alive watchdog is enabled. Node alive watchdog checks if the node is still alive and operational and if not kills the node.

      • Default : true
        • env : bamboo.node.alive.watchdog.enabled=false
        • java: -Dbamboo.node.alive.watchdog.enabled=false

      Since:
      9.4.0

    • NODE_ALIVE_WATCHDOG_INTERVAL_IN_SECONDS

      public static final SystemProperty.IntegerSystemProperty NODE_ALIVE_WATCHDOG_INTERVAL_IN_SECONDS
      The interval (in seconds) at which the node alive watchdog checks if the node is still alive and operational.

      • Default : 20
        • env : bamboo.node.alive.watchdog.interval.seconds=10
        • java: -Dbamboo.node.alive.watchdog.interval.seconds=10

      Since:
      9.4.0

    • CLUSTER_HEARTBEAT_ALIVE_TIMEOUT_IN_SECONDS

      public static final SystemProperty.IntegerSystemProperty CLUSTER_HEARTBEAT_ALIVE_TIMEOUT_IN_SECONDS
      The duration (in seconds) after which a node is considered dead if no heartbeat is received.

      • Default : 300
        • env : bamboo.cluster.heartbeat.alive.timeout.seconds=200
        • java: -Dbamboo.cluster.heartbeat.alive.timeout.seconds=200

      Since:
      9.4.0

    • CLUSTER_HEARTBEAT_JOB_INTERVAL_IN_SECONDS

      public static final SystemProperty.IntegerSystemProperty CLUSTER_HEARTBEAT_JOB_INTERVAL_IN_SECONDS
      The interval (in seconds) between two heartbeat jobs execution. The job contain the logic responsible for writing the heartbeat of the current node and refreshing internal cache of live nodes state.

      • Default : 30
        • env : bamboo.cluster.heartbeat.job.interval.seconds=60
        • java: -Dbamboo.cluster.heartbeat.job.interval.seconds=60

      Since:
      9.4.0

    • CLUSTER_CONNECT_SECONDARY_ONLY_IF_GRPC_COMMUNICATION_IS_WORKING

      public static final SystemProperty.BooleanSystemProperty CLUSTER_CONNECT_SECONDARY_ONLY_IF_GRPC_COMMUNICATION_IS_WORKING
      Determines whether secondary nodes should only connect if gRPC communication is working. We check whether the node can successfully connect to the primary node. If false, the secondary node will wait for other nodes to see its aliveness through the health check table, but there is no guarantee the gRPC is working, so the cluster might eventually be in a corrupted state.

      • Default: true
        • env: bamboo.cluster.connect.secondary.only.if.grpc.communication.is.working=true
        • java: -Dbamboo.cluster.connect.secondary.only.if.grpc.communication.is.working=true

      Since:
      9.6.0

    • OPTIMISTIC_LOCKING_MODE

      public static final SystemProperty OPTIMISTIC_LOCKING_MODE
      Optimistic locking mode. When false mechanism is disabled, when true enabled, when auto enabled only when at least two nodes exist.

      • Default : auto
        • env : bamboo.optimistic.locking.enabled=auto
        • java: -Dbamboo.optimistic.locking.enabled=auto

      Since:
      9.4.0

    • HTTP_CACHE_DISABLED

      public static final SystemProperty.BooleanSystemProperty HTTP_CACHE_DISABLED
      Disable caching of static resources like JS or PNG. Useful for plugin development. Should not be used in production.

      • Default : false
        • env : atlassian.disable.caches=true
        • java: -Datlassian.disable.caches=true

    • CUSTOM_LUCENE_INDICES_ALLOWED

      public static final SystemProperty.BooleanSystemProperty CUSTOM_LUCENE_INDICES_ALLOWED
      Enabled custom Lucene indices functionality in plugins.

      • Default : false
        • env : bamboo.custom.lucene.indices.allowed=true
        • java: -Dbamboo.custom.lucene.indices.allowed=true

    • FORCE_PULL_SPECS_RUNNER_IMAGE

      public static final SystemProperty.BooleanSystemProperty FORCE_PULL_SPECS_RUNNER_IMAGE
      Whether Bamboo should pull Docker image to run Specs processing even if it exists at local Docker cache.

      • Default : false
        • env : bamboo.repository.stored.specs.image.pull.force=true
        • java: -Dbamboo.repository.stored.specs.image.pull.force=true

    • SKIP_LOCAL_HOME_LOCK

      public static final SystemProperty.BooleanSystemProperty SKIP_LOCAL_HOME_LOCK
      Whether Bamboo should skip locking local home.

      • Default : false
        • env : bamboo.skip.local.home.lock=true
        • java: -Dbamboo.skip.local.home.lock=true

    • RENAME_USER_IN_HISTORICAL_DATA

      public static final SystemProperty.BooleanSystemProperty RENAME_USER_IN_HISTORICAL_DATA
      Whether Bamboo should go through all the historical data (trigger information, audit logs etc.) when username is changed.

      • Default : false
        • env : bamboo.rename.user.in.historical.data=true
        • java: -Dbamboo.rename.user.in.historical.data=true

      Since:
      8.0.3

    • VERIFY_INDEX_ON_STARTUP

      public static final SystemProperty.BooleanSystemProperty VERIFY_INDEX_ON_STARTUP
      Whether Bamboo should check Lucene index' integrity on startup.

      • Default : true
        • env : bamboo.verify.index.on.startup=true
        • java: -Dbamboo.verify.index.on.startup=true

      Since:
      8.1.0

    • MAX_PRIMARY_LOCK_ACQUISITION_ERRORS

      public static final SystemProperty.IntegerSystemProperty MAX_PRIMARY_LOCK_ACQUISITION_ERRORS
      Maximum number of database connection errors (the SQLState class '08') for which Bamboo will retry primary lock acquisition. If set to a negative number node will try to acquire the lock indefinitely.

      • Default : 10
        • env : bamboo.max.primary.lock.acquisition.errors=5
        • java: -Dbamboo.max.primary.lock.acquisition.errors=5

    • SKIP_SERVER_SIDE_VCS_MERGE

      public static final SystemProperty.BooleanSystemProperty SKIP_SERVER_SIDE_VCS_MERGE
      If Bamboo should skip server-side merge. Has no effect on plans with automatic push enabled.

      • Default : false
        • env : bamboo.skip.server.side.vcs.merge=true
        • java: -Dbamboo.skip.server.side.vcs.merge=true

    • PRIMARY_CLUSTER_LOCK_TIMEOUT_SECONDS

      public static final SystemProperty.IntegerSystemProperty PRIMARY_CLUSTER_LOCK_TIMEOUT_SECONDS
      How long (in seconds) does the Bamboo secondary node wait before deciding that primary node is no longer available.

      • Default : 60
        • env : bamboo.primary.node.lock.timeout.seconds=30
        • java: -Dbamboo.primary.node.lock.timeout.seconds=30

    • PLUGIN_SYSTEM_LOCK_TIMEOUT_SECONDS

      public static final SystemProperty.IntegerSystemProperty PLUGIN_SYSTEM_LOCK_TIMEOUT_SECONDS
      How long (in seconds) does the Bamboo plugin system wait before deciding that a taken lock expired and will be taken anyway. It helps to prevent starvation in case of node failure while a lock is taken.

      • Default : 120
        • env : bamboo.plugin.system.lock.timeout.seconds=120
        • java: -Dbamboo.plugin.system.lock.timeout.seconds=120

    • ARTIFACT_DOWNLOAD_IGNORES_SUCCESS_RESULT_REQUIREMENT

      public static final SystemProperty.BooleanSystemProperty ARTIFACT_DOWNLOAD_IGNORES_SUCCESS_RESULT_REQUIREMENT
      Whether Bamboo Artifact Download task may ignore requirement to find at least one successful build result when condition is present. See BAM-21886

      • Default : true
        • env : bamboo.task.artifact.download.ignores.success.result.when.conditional=false
        • java: -Dbamboo.task.artifact.download.ignores.success.result.when.conditional=false

      Since:
      8.0.12, 8.1.11, 8.2.7, 9.0.1, 9.1.0

    • BUILD_RESULT_RETRY_DELAY_SECONDS

      public static final SystemProperty.IntegerSystemProperty BUILD_RESULT_RETRY_DELAY_SECONDS
      How long (in seconds) Bamboo Agent should wait before attempting to resend a build result.

      • Default : 5
        • env : bamboo.agent.result.retry.delay=5
        • java: -Dbamboo.agent.result.retry.delay=5

    • ARTIFACT_TEMP_FOLDER

      public static final SystemProperty ARTIFACT_TEMP_FOLDER
      Custom artifact temporary storage path. Used by Artifact Servlet to unpack stream with artifacts sent to Bamboo Server by Bamboo server artifact handler. Should be used when performance of shared-home file system is not effective enough to handle high load during artifacts processing. Applicable to Bamboo Server/DC node only.

      • Default : empty
        • env : bamboo.artifact.temp.path=/opt/atlassian/bamboo/local-home/artifacts/tmp
        • java: -Dbamboo.artifact.temp.path=/opt/atlassian/bamboo/local-home/artifacts/tmp

    • FETCHING_LFS_FILES_ON_SERVER_ENABLED

      public static final SystemProperty.BooleanSystemProperty FETCHING_LFS_FILES_ON_SERVER_ENABLED
      Decides whether LFS files will be fetched during source code detection and Specs processing. By default, the LFS files will not be fetched.

      • Default : false
        • env : bamboo.fetching.lfs.files.enabled=true
        • java: -Dbamboo.fetching.lfs.files.enabled=true

    • JIRA_ISSUE_UPDATE_INTERVAL_SECONDS

      public static final SystemProperty.IntegerSystemProperty JIRA_ISSUE_UPDATE_INTERVAL_SECONDS
      How often Bamboo publishes issue updates to Jira, in seconds. If set to 0, events are published immediately.

      • Default : 20
        • env : bamboo.jira.update.interval.seconds=20
        • java: -Dbamboo.jira.update.interval.seconds=20

    • JIRA_ISSUE_UPDATE_MAX_DELAY_MULTIPLIER

      public static final SystemProperty.IntegerSystemProperty JIRA_ISSUE_UPDATE_MAX_DELAY_MULTIPLIER
      Maximum number of times Bamboo postpones updating Jira issue if issue is updated repeatedly. If set to 0, Bamboo does not postpone sending the event.

      • Default : 5
        • env : bamboo.jira.update.max.delay.multiplier=5
        • java: -Dbamboo.jira.update.max.delay.multiplier=5

    • DELETE_PLAN_BRANCH_WHEN_BRANCH_REMOVED_FROM_VCS

      public static final SystemProperty.BooleanSystemProperty DELETE_PLAN_BRANCH_WHEN_BRANCH_REMOVED_FROM_VCS
      When creating new Plans, controls if the "Delete plan branch - After branch was deleted from repository" property should be enabled by default

      • Default : false
        • env : bamboo.plan.branch.delete.when.removed.from.vcs=true
        • java: -Dbamboo.plan.branch.delete.when.removed.from.vcs=true

    • DELETE_PLAN_BRANCH_WHEN_BRANCH_IS_INACTIVE_IN_VCS

      public static final SystemProperty.BooleanSystemProperty DELETE_PLAN_BRANCH_WHEN_BRANCH_IS_INACTIVE_IN_VCS
      When creating new Plans, controls if the "Delete plan branch - After branch inactivity in repository" property should be enabled by default

      • Default : false
        • env : bamboo.plan.branch.delete.when.inactive.in.vcs=true
        • java: -Dbamboo.plan.branch.delete.when.inactive.in.vcs=true

    • SKIP_TEST_HISTORY_FEATURE_ENABLED

      public static final SystemProperty.BooleanSystemProperty SKIP_TEST_HISTORY_FEATURE_ENABLED
      Controls feature that allows disabling tracking of full history of all test cases.

      • Default : true
        • env : bamboo.no.test.history.feature.enabled=false
        • java: -Dbamboo.no.test.history.feature.enabled=false

    • ARTIFACT_COPY_BUFFER_SIZE

      public static final SystemProperty.IntegerSystemProperty ARTIFACT_COPY_BUFFER_SIZE
      Size of buffer for copying/saving artifact to disk. Should not be larger than Integer.MAX_VALUE, e.g. 2_147_483_647

      • Default : 1_048_576
        • env : bamboo.artifact.copy.buffer.size=3145728
        • java: -Dbamboo.artifact.copy.buffer.size=3145728

    • ARTIFACT_COMPRESSION_BUFFER_SIZE

      public static final SystemProperty.IntegerSystemProperty ARTIFACT_COMPRESSION_BUFFER_SIZE
      Size of buffer for compressing/decompressing artifacts. Should not be larger than Integer.MAX_VALUE, e.g. 2_147_483_647

      • Default : 1_048_576
        • env : bamboo.artifact.archive.buffer.size=3145728
        • java: -Dbamboo.artifact.archive.buffer.size=3145728

    • BRANCH_EVENT_HANDLERS_THREAD_POOL_SIZE

      public static final SystemProperty.IntegerSystemProperty BRANCH_EVENT_HANDLERS_THREAD_POOL_SIZE
      Maximum size of thread pools used to handle updating commit information on new chain branches and linking them with JIRA.

      • Default : 4
        • env : bamboo.branch.event.handlers.thread.pool.size=4
        • java: -Dbamboo.branch.event.handlers.thread.pool.size=4

    • ENABLE_ROBOTS_TXT

      public static final SystemProperty.BooleanSystemProperty ENABLE_ROBOTS_TXT
      Enable or disable serving of robots.txt file.

      • Default : false
        • env : bamboo.enable.robots.txt=true
        • java: -Dbamboo.enable.robots.txt=true

    • BAMBOO_GRPC_AUTHENTICATION_ENABLED

      public static final SystemProperty.BooleanSystemProperty BAMBOO_GRPC_AUTHENTICATION_ENABLED
      Enable authentication in gRPC communication.

      • Default : true
        • env : bamboo.grpc.authentication.enabled=false
        • java: -Dbamboo.grpc.authentication.enabled=false

    • BAMBOO_GRPC_AUTHENTICATION_SAVE_CLIENT_CERTIFICATES_TO_DISK

      public static final SystemProperty.BooleanSystemProperty BAMBOO_GRPC_AUTHENTICATION_SAVE_CLIENT_CERTIFICATES_TO_DISK
      Saves generated keys for gRPC client to the node local home.

      • Default : false
        • env : bamboo.grpc.authentication.save.client.certificates.to.disk=false
        • java: -Dbamboo.grpc.authentication.save.client.certificates.to.disk=false

    • BAMBOO_GRPC_AUTHENTICATION_ROOT_CA_FILENAME

      public static final SystemProperty.DefaultStringSystemProperty BAMBOO_GRPC_AUTHENTICATION_ROOT_CA_FILENAME
      Name of the file containing a certificate and its private key to be used with gRPC. Both need to be placed in this single file. The file has to be in PEM format and has to be placed in 'ssl' folder of the shared home. If the file does not exist, Bamboo generates a self-signed certificate.

      Supported private key types:

      • PKCS#8 Encrypted Private Keys
      • PKCS#8 Unencrypted Private Keys
      • Unencrypted RSA Private Keys
      • Unencrypted EC (Elliptic Curve) Private Keys
      • Encrypted RSA Private Keys
      • Encrypted EC (Elliptic Curve) Private Keys

      • Default : custom_ca.crt
        • env : bamboo.grpc.authentication.root.ca.filename=custom_ca.pem
        • java: -Dbamboo.grpc.authentication.root.ca.filename=custom_ca.pem

    • BAMBOO_GRPC_AUTHENTICATION_ROOT_CA_KEY_PASSPHRASE

      public static final SystemProperty.DefaultStringSystemProperty BAMBOO_GRPC_AUTHENTICATION_ROOT_CA_KEY_PASSPHRASE
      An encrypted passphrase used to encrypt gRPC certificate's private key. By default, the set encryption is Base64. You can change this behavior by setting up a different cipher class BAMBOO_GRPC_AUTHENTICATION_ROOT_CA_CIPHER.

      • Default : empty
        • env : bamboo.grpc.authentication.root.ca.key.passphrase=passphrase
        • java: -Dbamboo.grpc.authentication.root.ca.key.passphrase=passphrase

    • BAMBOO_GRPC_AUTHENTICATION_ROOT_CA_CIPHER

      public static final SystemProperty BAMBOO_GRPC_AUTHENTICATION_ROOT_CA_CIPHER
      Cipher class used for gRPC private key passphrase decryption. Available options are:
      • com.atlassian.secrets.store.algorithm.AesOnlyAlgorithmSecretStore
      • com.atlassian.secrets.store.aws.AwsSecretsManagerStore
      • com.atlassian.secrets.store.base64.Base64SecretStore
      • com.atlassian.secrets.store.vault.VaultSecretStore

      • Default : com.atlassian.secrets.store.base64.Base64SecretStore
      • Usage:
        • env : bamboo.grpc.authentication.root.ca.cipher=com.atlassian.secrets.store.algorithm.AesOnlyAlgorithmSecretStore
        • java: -Dbamboo.grpc.authentication.root.ca.cipher=com.atlassian.secrets.store.algorithm.AesOnlyAlgorithmSecretStore

    • GRPC_CERTIFICATE_VALIDITY_DURATION

      public static final SystemProperty.IntegerSystemProperty GRPC_CERTIFICATE_VALIDITY_DURATION
      Duration in years of generated by Bamboo self-signed certificate for gRPC connections.

      • Default : 20
        • env : bamboo.grpc.authentication.certificate.validity.duration=1
        • java: -Dbamboo.grpc.authentication.certificate.validity.duration=1

    • BAMBOO_ENABLE_GRPC_VIA_PROXY

      public static final SystemProperty.BooleanSystemProperty BAMBOO_ENABLE_GRPC_VIA_PROXY
      Enables gRPC communication via proxy. By default, gRPC communication bypasses the proxy.

      • Default : false
        • env : bamboo.enable.grpc.via.proxy=true
        • java: -Dbamboo.enable.grpc.via.proxy=true

    • GRPC_SERVER_THREADS_NUMBER

      public static final SystemProperty.IntegerSystemProperty GRPC_SERVER_THREADS_NUMBER
      The number of threads to use for the gRPC server scheduler.

      • Default : 6
        • env : bamboo.grpc.server.threads.number=8
        • java: -Dbamboo.grpc.server.threads.number=8

    • CROSS_NODES_EVENTS_GRPC_CLIENT_THREADS_NUMBER

      public static final SystemProperty.IntegerSystemProperty CROSS_NODES_EVENTS_GRPC_CLIENT_THREADS_NUMBER
      The number of threads to use for the gRPC client scheduler shared across all channels. This client scheduler is used for handling the cross node events requests.

      • Default : 6
        • env : "bamboo.cross.nodes.events.grpc.client.threads.number=8
        • java: -Dbamboo.cross.nodes.events.grpc.client.threads.number=8

    • PEER_TO_PEER_GRPC_CLIENT_THREADS_NUMBER

      public static final SystemProperty.IntegerSystemProperty PEER_TO_PEER_GRPC_CLIENT_THREADS_NUMBER
      The number of threads to use for the gRPC client scheduler shared across all channels. This client scheduler is used for handling the peer-to-peer requests.

      • Default : 2
        • env : "bamboo.peer.to.peer.grpc.client.threads.number=4
        • java: -Dbamboo.peer.to.peer.grpc.client.threads.number=4

    • PER_NODE_QUEUE_DISPATCHERS_THREADS_NUMBER

      public static final SystemProperty.IntegerSystemProperty PER_NODE_QUEUE_DISPATCHERS_THREADS_NUMBER
      The number of threads the per node queue dispatchers' executor will use. The executor is responsible for grabbing the items from the queues and dispatching them to the remote nodes. The gRPC client calls itself are executed on a separate executor.

      • Default : 4
        • env : bamboo.per.node.dispatchers.threads.number=8
        • java: -Dbamboo.per.node.dispatchers.threads.number=8

    • NUMBER_OF_PHYSICAL_QUEUES_UNDER_PER_NODE_QUEUE

      public static final SystemProperty.IntegerSystemProperty NUMBER_OF_PHYSICAL_QUEUES_UNDER_PER_NODE_QUEUE
      The number of physical queues under a single virtual per node queue. IMPORTANT: This value can be increased anytime. However, if this value is decreased, then it is necessary to shut down all Bamboo nodes, apply the new value and start the nodes again.

      • Default : 8
        • env : bamboo.physical.queues.per.node.queue=10
        • java: -Dbamboo.physical.queues.per.node.queue=10

    • PER_NODE_PHYSICAL_QUEUE_MAX_SIZE

      public static final SystemProperty.IntegerSystemProperty PER_NODE_PHYSICAL_QUEUE_MAX_SIZE
      The maximum number of elements in a single physical queue under virtual per node queue. If -1, there is no limit.

      • Default : -1
        • env : bamboo.per.node.physical.queue.max.size=1000
        • java: -Dbamboo.per.node.physical.queue.max.size=1000

    • PER_NODE_PHYSICAL_QUEUE_MAX_USED_BYTES

      public static final SystemProperty.IntegerSystemProperty PER_NODE_PHYSICAL_QUEUE_MAX_USED_BYTES
      The maximum size in bytes of a single physical queue under virtual per node queue. If -1, there is no limit.

      • Default : -1
        • env : bamboo.per.node.physical.queue.max.used.bytes=10000
        • java: -Dbamboo.per.node.physical.queue.max.used.bytes=10000

    • PER_NODE_QUEUE_STATS_LOGGING_INTERVAL_MINUTES

      public static final SystemProperty.IntegerSystemProperty PER_NODE_QUEUE_STATS_LOGGING_INTERVAL_MINUTES
      The interval between two consecutive logging entries of per node queue stats. The interval is in minutes. If smaller or equal to 0, the default will be set automatically. The queue stats can't be turned off as they are crucial for understanding Bamboo's performance.

      • Default : 10
        • env : bamboo.per.node.queue.stats.logging.interval.minutes=5
        • java: -Dbamboo.per.node.queue.stats.logging.interval.minutes=5

    • BAMBOO_CLUSTER_INFO_CACHE_TTL_SECONDS

      public static final SystemProperty.IntegerSystemProperty BAMBOO_CLUSTER_INFO_CACHE_TTL_SECONDS
      A time to live in seconds for the cluster info cache. The cluster info contains such information as the current state of the cluster, such as whether it is running, paused, etc.

      • Default : 120
        • env : bamboo.cluster.info.cache.ttl=60
        • java: -Dbamboo.cluster.info.cache.ttl=60

    • UPM_PLUGIN_UPLOAD_ENABLED

      public static final SystemProperty.BooleanSystemProperty UPM_PLUGIN_UPLOAD_ENABLED
      Allow installation of apps from filesystem via Universal Plugin Manager UI. Should be used if instance have to use custom plugins not available at Marketplace.

      • Default : false
        • env : upm.plugin.upload.enabled=true
        • java: -Dupm.plugin.upload.enabled=true

    • LOG_MESSAGE_ESCAPE_ENABLED

      public static final SystemProperty.BooleanSystemProperty LOG_MESSAGE_ESCAPE_ENABLED
      Enable or disable escaping of log messages. The following characters will be escaped:
      • '>' to '&gt;'
      • '<' to '&lt;'
      • newline characters (CR, LF) will be displayed as newline with "(log message continued...) ►" text.
      • Default: true
        • env: bamboo.log.message.escape=true
        • java: -Dbamboo.log.message.escape=true

    • LOG_MESSAGE_MAX_LENGTH

      public static SystemProperty.IntegerSystemProperty LOG_MESSAGE_MAX_LENGTH
      Define the maximum length for log messages. This setting only applies to the log message content and does not include the stack trace. Setting it too low might truncate important log information. To disable, set value to Max. 500 is default value recommended by OWASP: recommended by OWASP

      • Default : 10000
      • Max: 2147483647
        • env : bamboo.log.message.max.length=10000
        • java: -Dbamboo.log.message.max.length=10000

    • ALLOW_FREEMARKER_TEMPLATES_AT_WEBHOOK_PAYLOAD

      public static final SystemProperty.BooleanSystemProperty ALLOW_FREEMARKER_TEMPLATES_AT_WEBHOOK_PAYLOAD
      Allow to use Freemarker template engine for Webhook payload rendering. When enabled user can use builtin Freemarker functions and syntax to use advanced way of webhook payload modification.

      • Default : false
        • env : bamboo.security.allow.freemarker.at.webhook.payload=true
        • java: -Dbamboo.security.allow.freemarker.at.webhook.payload=true

    • DISABLE_CHECK_EXISTING_DB_DATA_IN_DEV_MODE

      public static final SystemProperty.BooleanSystemProperty DISABLE_CHECK_EXISTING_DB_DATA_IN_DEV_MODE
      Disable checking if database contains some data (only in DevMode).

      • Default : false
        • env : bamboo.setup.dev.mode.check.db.disable=true
        • java: -Dbamboo.setup.dev.mode.check.db.disable=true

    • SYSTEM_INFO_SCHEDULER_CRON

      public static final SystemProperty SYSTEM_INFO_SCHEDULER_CRON
      Quartz cron expression to schedule the SystemInfoJob. To disable the Job, set the property value to "false" The pattern is in the format: "Seconds Minutes Hours Day-of-Month Month Day-of-Week Year (optional)". Each field can have a specific value, a comma-separated list of values, a range, or an asterisk (*) for 'every'. Question mark (?) can be used to specify 'no specific value'. A few examples of Quartz cron expressions: - "0 0 * * * ?" : Every hour - "0 0 0/2 * * ?" : Every 2 hours - "0 0/10 * * * ?" : Every 10 minutes - "0 0 12 * * ?" : 12 pm every day. - "0 15 10 ? * *" : 10:15 am every day.

      • Default : "0 0 1 * * ?" (1 am every day)
        • env : bamboo.system.info.cron="0 0 0/2 * * ?"
        • java: -Dbamboo.system.info.cron="0 0 0/2 * * ?"

    • GITHUB_BUILD_STATUS_HANDLING_ENABLED

      public static final SystemProperty.BooleanSystemProperty GITHUB_BUILD_STATUS_HANDLING_ENABLED
      Whether the Bamboo will send build statuses to GitHub.

      • Default : true
        • env : bamboo.github.build.status.handling.enabled=false
        • java: -Dbamboo.github.build.status.handling.enabled=false

    • J_GIT_DISABLED

      @Deprecated public static final SystemProperty.BooleanSystemProperty J_GIT_DISABLED
      Deprecated.
      Whether JGit support is disabled.

      • Default : false
        • env : bamboo.jgit.disabled=true
        • java: -Dbamboo.jgit.disabled=true

      Since:
      10.0, this system property will be removed in the future when JGit is completely removed.

    • DEFAULT_ENDPOINT_TO_LICENSED_ACCESS

      public static final SystemProperty.BooleanSystemProperty DEFAULT_ENDPOINT_TO_LICENSED_ACCESS
      Whether unannotated endpoints (Servlets, Filters, Struts actions) need an authenticated user for access

      • Default : true
        • env : bamboo.security.endpoint.annotation.default.to.licensed.access=true
        • java: -Dbamboo.security.endpoint.annotation.default.to.licensed.access=true

    • WEBSUDO_DISABLED

      public static SystemProperty.BooleanSystemProperty WEBSUDO_DISABLED
      Completely disables web sudo and related ip whitelisting checks.

    • WEBSUDO_SESSION_DURATION

      public static SystemProperty.IntegerSystemProperty WEBSUDO_SESSION_DURATION
      The duration of the websudo session in seconds

    • WEBSUDO_SESSION_DURATION_TOLERANCE

      public static SystemProperty.IntegerSystemProperty WEBSUDO_SESSION_DURATION_TOLERANCE
      We include a tolerance to the web sudo session duration comparison to account for slight differences in the clock's time across nodes. This value is in seconds.

    • ATLASSIAN_AUTHENTICATION_BAMBOO_LEGACY_MODE

      public static final SystemProperty.BooleanSystemProperty ATLASSIAN_AUTHENTICATION_BAMBOO_LEGACY_MODE
      Controls if two-step verification with new UI/UX flow is used or legacy mode (provides only basic auth + SSO). This property is used when the `atlassian.authentication.legacy.mode` property from the authentication plugin is not specified. It lets declare the Bamboo product's default.

      • Default : false
        • env : atlassian.authentication.bamboo.legacy.mode=true
        • java: -Datlassian.authentication.bamboo.legacy.mode=true

      Since:
      10.1

    • DEPLOYMENT_CACHE_ON

      public static final SystemProperty.BooleanSystemProperty DEPLOYMENT_CACHE_ON
      Controls deployment caching level. If true, both deployment projects and environments are cached. If false, only deployment projects are.
      Since:
      11.0

      • Default : true
        • env : bamboo.deployment.cache.enabled=true
        • java: -Dbamboo.deployment.cache.enabled=true

    • HTTP_HEADER_SECURITY_DISABLED

      public static final SystemProperty.BooleanSystemProperty HTTP_HEADER_SECURITY_DISABLED
      Disables the HTTP security headers

      This property will disable com.atlassian.bamboo.filter.BambooHttpHeaderSecurityFilter

      • Default: false
        • env: bamboo.http.header.security.disabled=true
        • java: -Dbamboo.http.header.security.disabled=true
      Since:
      10.0.2

    • HTTP_HEADER_SECURITY_HSTS_DISABLED

      public static final SystemProperty.BooleanSystemProperty HTTP_HEADER_SECURITY_HSTS_DISABLED
      Disables the HTTP Strict Transport Security (HSTS) header
      • Default: false
        • env: bamboo.http.header.security.hsts.disabled=false
        • java: -Dbamboo.http.header.security.hsts.disabled=true
      Since:
      10.0.2

    • HTTP_HEADER_SECURITY_HSTS_MAX_AGE

      public static final SystemProperty.IntegerSystemProperty HTTP_HEADER_SECURITY_HSTS_MAX_AGE
      Specifies the max-age directive for the HTTP Strict Transport Security (HSTS) header

      The max-age directive defines the time, in seconds, that the browser should remember that a site is only to be accessed using HTTPS

      • Default: 31,536,000 (1 year)
        • env: bamboo.http.header.security.hsts.max.age=50000000
        • java: -Dbamboo.http.header.security.hsts.max.age=50000000
      Since:
      10.0.2

    • HTTP_HEADER_SECURITY_HSTS_PRELOAD_ENABLED

      public static final SystemProperty.BooleanSystemProperty HTTP_HEADER_SECURITY_HSTS_PRELOAD_ENABLED
      Enables the "preload" directive for HTTP Strict Transport Security (HSTS)

      When set to true, the "preload" directive is included in the HSTS header, indicating that the site should be included in browser preload lists. Preloading allows browsers to enforce HSTS even on the first request to the website

      • Default: false
        • env: bamboo.http.header.security.hsts.preload.enabled=true
        • java: -Dbamboo.http.header.security.hsts.preload.enabled=true
      Since:
      10.0.2

    • HTTP_HEADER_SECURITY_HSTS_INCLUDE_SUB_DOMAINS

      public static final SystemProperty.BooleanSystemProperty HTTP_HEADER_SECURITY_HSTS_INCLUDE_SUB_DOMAINS
      Controls the inclusion of subdomains in the HTTP Strict Transport Security (HSTS) policy

      The "includeSubDomains" directive is added to the HSTS header, applying the HSTS policy to all subdomains of the website

      • Default: false
        • env: bamboo.http.header.security.hsts.include.subdomains=true
        • java: -Dbamboo.http.header.security.hsts.include.subdomains=true
      Since:
      10.0.2

    • HTTP_HEADER_SECURITY_ANTI_CLICKJACKING_PROTECTION_DISABLED

      public static final SystemProperty.BooleanSystemProperty HTTP_HEADER_SECURITY_ANTI_CLICKJACKING_PROTECTION_DISABLED
      Disables Anti Clickjacking protection
      • Default: false
        • env: bamboo.http.header.security.anti.clickjacking.disabled=true
        • java: -Dbamboo.http.header.security.anti.clickjacking.disabled=true
      Since:
      10.0.2

    • HTTP_HEADER_SECURITY_ANTI_CLICKJACKING_X_FRAME_OPTIONS_VALUE

      public static final SystemProperty HTTP_HEADER_SECURITY_ANTI_CLICKJACKING_X_FRAME_OPTIONS_VALUE
      Controls the inclusion of the X-Frame-Options header value for Clickjacking protection
      • Default: SAMEORIGIN
      • Permitted values: DENY, SAMEORIGIN
        • env: bamboo.http.header.security.anti.clickjacking.x_frame_options=DENY
        • java: -Dbamboo.http.header.security.anti.clickjacking.x_frame_options=DENY
      Since:
      10.0.2

    • HTTP_HEADER_SECURITY_CSP

      public static final SystemProperty HTTP_HEADER_SECURITY_CSP
      Specifies the Content Security Policy (CSP) header value

      This property allows customization of the CSP header, which helps mitigate XSS and other attacks by specifying which sources of content are allowed. If the property is declared, the specified string is parsed as the CSP header value. If the policy string fails validation, it will not be applied, effectively disabling CSP enforcement

      Setting a restrictive CSP may break the application. It is recommended to validate the policy in a non-production instance before applying it in production

      • Default: empty (disabled)
        • env: bamboo.http.header.security.csp="default-src * 'unsafe-inline' 'unsafe-eval' data: blob:;"
        • java: -Dbamboo.http.header.security.csp="default-src * 'unsafe-inline' 'unsafe-eval' data: blob:;"
      Since:
      10.0.2

    • HTTP_HEADER_SECURITY_REFERRER_POLICY

      public static final SystemProperty HTTP_HEADER_SECURITY_REFERRER_POLICY
      Specifies the Referrer Policy header value

      This property allows customization of the Referrer-Policy header, which controls the amount of referrer information sent with requests

      • Default: no-referrer-when-downgrade
        • env: bamboo.http.header.security.referrer.policy="value"
        • java: -Dbamboo.http.header.security.referrer.policy="value"
      • Permitted values:
          no-referrer|no-referrer-when-downgrade|origin|origin-when-cross-origin|
          strict-origin|strict-origin-when-cross-origin|unsafe-url
      Since:
      10.0.2

    • HTTP_HEADER_SECURITY_PERMISSIONS_POLICY

      public static final SystemProperty HTTP_HEADER_SECURITY_PERMISSIONS_POLICY
      Specifies the Permissions Policy (formerly Feature-Policy) header value

      This property allows customization of the Permissions-Policy header, which controls which features can be used by the site. If the property is declared, the specified string is parsed as the Permissions-Policy header value. If the policy string fails validation it will not be applied, effectively disabling Permission Policy enforcement

      • Default: empty (disabled)
        • env: bamboo.http.header.security.permissions.policy="geolocation=(), microphone=(), camera=()"
        • java: -Dbamboo.http.header.security.permissions.policy="geolocation=(), microphone=(), camera=()"
      Since:
      10.0.2

    • HTTP_HEADER_SECURITY_XSS_PROTECTION_DISABLED

      public static final SystemProperty.BooleanSystemProperty HTTP_HEADER_SECURITY_XSS_PROTECTION_DISABLED
      Disables the XSS Protection header
      • Default: false
        • env: bamboo.http.header.security.xss.protection.disabled=true
        • java: -Dbamboo.http.header.security.xss.protection.disabled=true
      Since:
      10.0.2

    • HTTP_HEADER_SECURITY_X_CONTENT_TYPE_OPTIONS_NOSNIFF_DISABLED

      public static final SystemProperty.BooleanSystemProperty HTTP_HEADER_SECURITY_X_CONTENT_TYPE_OPTIONS_NOSNIFF_DISABLED
      Disables the X-Content-Type-Options header

      This property takes precedence over the deprecated DISABLE_X_CONTENT_TYPE_OPTIONS_NOSNIFF

      Disable adding 'X-Content-Type-Options: nosniff' to all pages served by Bamboo. A presence of this header helps prevent attacks based on MIME type confusion.

      In very edge cases, a presence of this header may cause problems with proper detection of MIME type of artifacts being downloaded in case when: a) the 'file extension-mime type' mapping is not defined or is incorrectly defined in webapp/WEB-INF/mimetype.xml b) type detection is performed by a browser by analysing file's content

      In such cases, it's recommended to add proper entry in mimetype.xml. Disabling the header is the last resort

      • Default: false
        • env: bamboo.http.header.security.x_content_type_options.nosniff.disabled=true
        • java: -Dbamboo.http.header.security.x_content_type_options.nosniff.disabled=true
      Since:
      10.0.2

    • FREEMARKER_BAMBOO_ALLOWLIST_DEBUG_MODE

      public static final SystemProperty.DefaultStringSystemProperty FREEMARKER_BAMBOO_ALLOWLIST_DEBUG_MODE
      Specifies the debug mode for the Freemarker Bamboo allowlist.

      This property controls the behavior of the debug mode with the following possible values:

      • off: Debug mode is disabled.
      • devmode: Debug mode is enabled in development mode and disabled in production mode.
      • on: Debug mode is always enabled.

      Default value: off

      This property can be configured using:

      • env: freemarker.bamboo.allowlist.debug.mode=value
      • java: -Dfreemarker.bamboo.allowlist.debug.mode=value
      Since:
      11.0

    • DISABLE_BBDC_CHANGE_DETECTION_FOR_PULL_REQUESTS_FROM_FORKED_REPOSITORIES

      public static final SystemProperty.BooleanSystemProperty DISABLE_BBDC_CHANGE_DETECTION_FOR_PULL_REQUESTS_FROM_FORKED_REPOSITORIES
      Disables change detection for branches created with pull requests originating from forked Bitbucket DC repositories. There are two purposes for this:
      • Improved performance of the Bamboo instance. Handling this functionality has a major performance overhead.
      • Improved security, as the builds coming for pull requests from forked repositories can only be triggered manually after previous verification.
      By default, this functionality is enabled. If you do not use forked repositories, we encourage you to disable it.

      • Default: false
        • env: bamboo.disable.bbdc.change.detection.for.prs.from.forked.repos=true
        • java: -Dbamboo.disable.bbdc.change.detection.for.prs.from.forked.repos=true
      Since:
      11.0.0

  • Constructor Details

    • SystemProperty

      public SystemProperty(boolean mandatory, String... properties)
      Creates an instance containing the value of the given property - logs an error if it cannot be found
      Parameters:
      mandatory - Is the property mandatory or optional?
      properties - The property we're loading from the environment (first name found will be loaded)

    • SystemProperty

      protected SystemProperty(String property, boolean mandatory, org.apache.log4j.Logger log)
      Used in testing
      Parameters:
      property - The property we're loading from the environment
      mandatory - Is the property mandatory or optional?
      log - The logger we're logging errors to