Features controlled by system properties

Hudson Features Controlled with System Properties

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

  • Property - Java property name
  • Default - Default value if not explicitly set
  • Version - The version of Hudson the property was introduced in
  • Notes - Other notes
Property Default Version Notes
hudson.consoleTailKB 150   How many KB of console log to show in default console view
hudson.diyChunking false   Set to true if the servlet container doesn't support chunked encoding.
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
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 Hudson 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.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   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.ExtendedReadPermisson false 1.324 The ExtendedReadPermission allows read-only access to adminstrative pages; can also enable with extended-read-permission plugin
hudson.security.LDAPSecurityRealm.groupSearch Mouseover   LDAP filter to look for groups by their names
hudson.tasks.ArtifactArchiver.warnOnEmpty false   When true, builds don't fail when there is nothing to archive
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
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.symlinkEscapeHatch false   True to use exec of "ln" binary to create symbolic links instead of native code
hudson.ClassicPluginStrategy.useAntClassLoader false  
hudson.diagnosis.HudsonHomeDiskUsageChecker.freeSpaceTheshold
1073741824
1.339
The notification threshold for when the Hudson home directory is running low on disk space, in bytes.
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.

Labels:

Enter labels to add to this page:
Wait Image 
Looking for a label? Just start typing.