View Source

h1. Jenkins Features Controlled with System Properties

Jenkins has several "hidden" features that can be enabled with system properties. System properties are defined by passing \-D<property name>=<value> when you start Jenkins. The following table lists the properties and the version of Jenkins they were introduced in.

* *Property* \- Java property name
* *Default* \- Default value if not explicitly set
* *Version* \- The version of Jenkins the property was introduced in
* *Notes* \- Other notes

| *Property* | *Default* | *Version* | *Notes* |
| hudson.ClassicPluginStrategy.useAntClassLoader | false | 1.316 | |
| hudson.consoleTailKB | 150 | | How many KB of console log to show in default console view |
| hudson.diagnosis.HudsonHomeDiskUsageChecker.freeSpaceThreshold | 1073741824 | 1.339 | The notification threshold for when the Hudson home directory is running low on disk space, in bytes |
| hudson.diyChunking | false | | Set to true if the servlet container doesn't support chunked encoding |
| hudson.DNSMultiCast.disabled | false | 1.359 | Set to "true" to disable DNS multicast |
| hudson.footerURL | [http://jenkins-ci.org/] | 1.416 | Allows tweaking the URL displayed at the bottom of Jenkins' UI |
| hudson.Functions.autoRefreshSeconds | 10 | 1.365 | Number of seconds between reloads when Auto Refresh is enabled |
| hudson.lifecycle | | | Specify full class name for Lifecycle implementation to override default |
| hudson.matrix.MatrixConfiguration.useShortWorkspaceName | false | | Use shorter but cryptic names to avoid 256 character limit on paths in [Cygwin|MatrixConfiguration#useShortWorkspaceName@javadoc] |
| hudson.model.DownloadService.never | false | | Suppress the periodic download of data files for plugins |
| hudson.model.Hudson.flyweightSupport | was:false \\
1.337:true | 1.318 | Matrix parent job won't consume an executor when true |
| hudson.model.Hudson.killAfterLoad | false | | Exit Jenkins right after loading |
| hudson.model.Hudson.logStartupPerformance | false | | Log startup timing info |
| hudson.model.Hudson.parallelLoad | true | | Loads job configurations in parallel on startup |
| hudson.model.LoadStatistics.clock | 10000 | | Load statistics clock cycle in milliseconds |
| hudson.model.LoadStatistics.decay | 0.9 | | Decay ratio for every clock cycle in node utilization charts |
| hudson.model.Run.ArtifactList.listCutoff | 16 | 1.330 | More artifacts than this will use tree view or simple link rather than listing out artifacts |
| hudson.model.Run.ArtifactList.treeCutoff | 40 | 1.330 | More artifacts than this will show a simple link to directory browser rather than showing artifacts in tree view |
| hudson.model.UpdateCenter.never | false | | When true, don't automatically check for new versions |
| hudson.model.WorkspaceCleanupThread.disabled | false | | Don't clean up old workspaces on slave nodes |
| hudson.os.solaris.ZFSInstaller.disabled | false | | True to disable ZFS monitor on Solaris |
| hudson.remoting.Launcher.pingIntervalSec | 600 | 1.367 | Seconds between ping checks to monitor health of slave nodes; 0 to disable ping |
| hudson.remoting.Launcher.pingTimeoutSec | 240 | 1.367 | If ping of slave node takes longer than this, consider it dead; 0 to disable ping |
| hudson.PluginStrategy | | | Allow plugins to be loaded into a different environment, such as an existing DI container like Plexus; specify full class name here to override default ClassicPluginStrategy |
| hudson.scheduledRetention | false | Up to 1.354 | Control a slave based on a schedule |
| hudson.scm.CVSSCM.skipChangeLog | false | | Useful with ancient versions of CVS that don't support the \-d option in the log command |
| hudson.security.csrf.requestfield | .crumb | 1.310 | Parameter name that contains a crumb value on POST requests |
| hudson.security.ArtifactsPermission | false | 1.374 | The Artifacts permission allows to control access to artifacts; When this property is unset or set to false, access to artifacts is not controlled |
| hudson.security.ExtendedReadPermission | false | 1.324 | The ExtendedReadPermission allows read-only access to adminstrative pages; can also enable with extended-read-permission plugin |
| hudson.security.WipeOutPermission | false | 1.416 | The WipeOut permission allows to control access to the "Wipe Out Workspace" action, which is normally available as soon as the Build permission is granted |
| hudson.security.LDAPSecurityRealm.groupSearch | [Mouseover|#here|(& (cn=\{0\}) (\| (objectclass=groupOfNames) (objectclass=groupOfUniqueNames) (objectclass=posixGroup)))] | | LDAP filter to look for groups by their names |
| hudson.slaves.ChannelPinger.pingInterval | 5 | 1.405 | Frequency (in minutes) of pings between the master and slaves |
| hudson.slaves.WorkspaceList | @ | 1.424 | When concurrent builds is enabled, a unique workspace directory name is required for each concurrent build. To create this name, this token is placed between project name and a unique ID, e.g. "my-project@123". |
| hudson.tasks.ArtifactArchiver.warnOnEmpty | false | | When true, builds don't fail when there is nothing to archive |
| hudson.tasks.Fingerprinter.enableFingerprintsInDependencyGraph | false | 1.430 | When true, jobs associated through fingerprints are added to the dependency graph, even when there is no configured upstream/downstream relationship between them. |
| hudson.tasks.MailSender.maxLogLines | 250 | | Number of lines of console output to include in emails |
| hudson.TreeView | false | | Experimental nested views feature |
| hudson.triggers.SCMTrigger.starvationThreshold | 1 hour | | Milliseconds waiting for polling executor before trigger reports it is clogged |
| hudson.udp | 33848 | | Port for UDP multicast broadcast (set to \-1 to disable) |
| hudson.upstreamCulprits | false | 1.327 | Pass blame information to downstream jobs |
| hudson.Util.noSymLink | false | | True to disable creation of symbolic links in job/builds directories |
| hudson.util.ProcessTree.disable | false | | True to disable cleanup of child processes |
| hudson.util.Secret.provider | | 1.360 | Force a particular crypto provider; with Glassfish Enterprise set value to {{SunJCE}} to workaround a [known issue|6459@issue]. |
| hudson.Util.symlinkEscapeHatch | false | | True to use exec of "ln" binary to create symbolic links instead of native code |

{note:title=No compatibility guarantee}In general, these switches are often experimental in nature, and subject to change without notice. If you find some of those useful, please file a ticket to promote it to the official feature.{note}