Skip to content
Manage JenkinsSign in

System

Configure global settings and paths.
General
Home directory?
By default, Jenkins stores all of its data in this directory on the file system
/root/.jenkins
System Message
This message will be displayed at the top of the Jenkins main page. This can be useful for posting notifications to your users
Plain textPreviewHide preview
Built-In Node is now configured in Nodes.
Computer Retention Check Interval?
Quiet period?
SCM checkout retry count
Naming Strategy
Strategy
?
?
Name Pattern
Description?
Jenkins Location
Jenkins URL?
System Admin e-mail address?
Serve resource files from another domain
Resource Root URL?
Global properties
?
Free Disk Space Threshold?
Free Disk Space Warning Threshold?
Free Temp Space Threshold?
Free Temp Space Warning Threshold?
List of variables?
Name
Value
List of tool locations?
Name
Home
Metrics
Access keys?
Key
Copy this token now, because it cannot be recovered in the future.
Description
Permissions
Origins
Pipeline Speed / Durability
Default Speed / Durability Level?
Usage Statistics
?
Folder Health Metrics
List of default health metrics for Folders
Child item with the given name
Child item with worst health
Health of the primary branch of a repository ?
Bitbucket Endpoints
Bitbucket Cloud
How long to cache team, in minutes
How long to cache repositories, in minutes
Webhook management ?
Credentials
Custom Jenkins Root URL
HMAC Credentials
Skip certificate verification?
How long to cache webhook requests, in minutes
Bitbucket Cloud
Bitbucket Data Center
GitLab
Enable authentication for '/project' end-point?
GitLab connections
Connection name?
A name for the connection
GitLab host URL?
The complete URL to the GitLab server (e.g. http://gitlab.mydomain.com)
Credentials?
API Token for accessing GitLab
Edited
API-Level?
API Level for accessing GitLab
Ignore SSL Certificate Errors?
Connection timeout (in seconds)?
The time to wait for establishing the connection
Read timeout (in seconds)?
The time to wait while receiving the response
Connection name?
A name for the connection
GitLab host URL?
The complete URL to the GitLab server (e.g. http://gitlab.mydomain.com)
Credentials?
API Token for accessing GitLab
Edited
API-Level?
API Level for accessing GitLab
Ignore SSL Certificate Errors?
Connection timeout (in seconds)?
The time to wait for establishing the connection
Read timeout (in seconds)?
The time to wait while receiving the response
HTTP Proxy Configuration
Edited
Server
Port
User name
Password
No Proxy Host
Edited
Test URL
Global Build Time Out
Time-out strategy
Time-out actions
Abort the build ?
Abort the build ?
Fail the build ?
Perform BuildStep ?
Writing the build description ?
Develocity Build Scans
?
?
Develocity server URL override?
Develocity access key for build scan values?
HTTP client settings
Timeout in seconds?
Maximum retries?
Delay between retries in seconds?
Develocity integration
Develocity Access Key credential ID?
Develocity short-lived access tokens expiry?
Develocity connection settings
Develocity server url?
?
?
General settings
Auto-injection Git VCS repository filters [Beta]?
Gradle settings
Develocity Gradle plugin version?
Common Custom User Data Gradle plugin version?
Gradle plugin repository url?
Gradle plugin repository credential ID?
Gradle auto-injection enabled nodes?
Node Label
Gradle auto-injection disabled nodes?
Node Label
?
Maven settings
Develocity Maven extension version?
Common Custom User Data Maven extension version?
Maven extension repository url?
Maven Extension repository credential ID?
Develocity Maven Extension Custom Coordinates?
Common Custom User Data Maven Extension Custom Coordinates?
Maven auto-injection enabled nodes?
Node Label
Maven auto-injection disabled nodes?
Node Label
?
Timestamper
System clock time format?
Elapsed time format?
?
Fingerprints
Administrative monitors
Administrative monitors are warnings shown to Jenkins administrators about the state of the Jenkins instance. It is generally strongly recommended to keep all administrative monitors enabled, but if you are not interested in specific warnings, uncheck them here to permanently hide them.
Edited
Security
Security
When updating Jenkins from before 2.307, this allows administrators to migrate the built-in node name and label.
Security
Shows a warning when the built-in node has executors despite agents (static or clouds) being configured.
Security
Shows a warning when the built-in node has executors and recommends that agents (static or clouds) are set up.
Security
Warns about disabled CSRF protection.
A diagnostic feature warnings administrators about incorrect encoding of URLs, typically with improperly set up reverse proxies or containers.
This warns administrators that triggers are not firing on schedule, typically because some plugins perform additional actions (like network access) during trigger processing.
When Jenkins detects a cyclic dependency between plugins (a bug in one or more plugins), this message is shown.
Informs administrators about the deprecation of one or more currently installed plugins. This is metadata provided by the configured update sites, and the plugin documentation will usually explain why the plugin is deprecated.
Security
Authentication (security realm) and authorization (authorization strategy) should be set up.
This warning shows up when the available disk space for the Jenkins home directory falls below a certain threshold.
Detects if more than one Jenkins process is attempting to run in the same $JENKINS_HOME directory simultaneously.
Informs administrators that the TCP agent port is different than its enforced value and will be reset on restart.
Allows administrators to migrate folder properties that have been deprecated in previous plugin releases.
Warns about duplicate events received from GitHub.
Informs administrators about a required plugin update. This is unrelated to plugin updates being available.
Informs about the presence of JRE crash dumps after an abnormal Jenkins termination, and allows viewing them.
Warns about an incomplete initialization, indicating a bug in Jenkins.
When a new release of Jenkins has been released, this informs administrators about it.
Security
Warns administrators about the legacy behavior of allowing users to generate new legacy API tokens.
Security
Warns administrators about the legacy behavior of automatically generating API tokens for new users.
Security
Warns administrators about the presence of legacy API tokens in the configuration of some users.
When Jenkins configuration files contain unloadable data, this informs administrators about the problem. A common cause is plugins having been downgraded, or having changed in backwards-incompatible ways.
Informs administrators about a problem with extensions in some legacy plugins.
Security
Whenever a resource monitor marks a node offline, this warning is shown to inform administrators about it.
Warns administrators when the controller operating system is approaching end of life and will be unsupported
If any plugins failed to load, this informs administrators about the problem. This is a severe problem, as re-saving configuration at this point could result in the loss of configuration data related to unloadable plugins.
Security
Recommend setting up Content Security Policy for the Jenkins UI.
Recommends a Java upgrade for Jenkins if an older Java version is used.
Informs administrators of new features available for existing GitHub App credentials that allow dynamic restriction of the repositories and permissions available to jobs that use the credentials
Security
Informs about the resource root URL option if the Content-Security-Policy HTTP header for user-controlled resources served by Jenkins has been set to a custom value. Learn more.
If Jenkins is running behind a reverse proxy, this identifies problems with a bad configuration.
Some Jenkins features require the root URL to be defined, and this warns when it is undefined.
Recommends the creation of additional views to help categorize jobs if there are none and too many jobs exist.
If there are more SCM polling activities scheduled than Jenkins can handle in parallel, this informs administrators about the problem and provides diagnostic information.
Security
This warning informs administrators about active security warnings for installed Jenkins core or plugin versions. Rather than disable this warning entirely (including any future issues), consider disabling specific messages in the global security configuration.
Security
This administrative monitor alerts when the Default Crumb Issuer is configured to exclude session IDs from CSRF protection. Jenkins no longer includes the IP address in the CSRF crumb generation, so removing the session ID from the CSRF protection weakens security considerably.
Global Build Discarders
Project Build Discarder
Build discarders configured for a job are only run after a build finishes. This option runs jobs' configured build discarders periodically, applying configuration changes even when no new builds are run. This option has no effect if there is no build discarder configured for a job.
Project Build Discarder
Specific Build Discarder
Default notification URL
Notification URL?
GitHub
GitHub Servers?
GitHub Server ?
Edited
Override Hook URL
Shared secrets
Shared secret?
Signature algorithm?
Additional actions?
Convert login and password to token ?
GitHub API usage
Github API usage rate limiting strategy?
GitHub Enterprise Servers
API endpoint?
Name
Generic Webhook Trigger Whitelist
?
Whitelisted servers
IP, CIDR or IP range?
HMAC Header?
HMAC Secret?
HMAC Algorithm
It supports whitelisted IP/Host and HMAC verification.
Global Trusted Pipeline Libraries
Sharable libraries available to any Pipeline jobs running on this system. These libraries will be trusted, meaning they run without “sandbox” restrictions and may use @Grab.
Library
Name?
Default version?
Load implicitly?
Allow default version to be overridden?
Include @Library changes in job recent changes?
?
Refresh time in minutes?
Versions to exclude?
Versions to include?
Force clear cache?
Retrieval method
Global Untrusted Pipeline Libraries
Sharable libraries available to any Pipeline jobs running on this system. These libraries will be untrusted, meaning they run with “sandbox” restrictions and cannot use @Grab.
Library
Name?
Default version?
Load implicitly?
Allow default version to be overridden?
Include @Library changes in job recent changes?
?
Refresh time in minutes?
Versions to exclude?
Versions to include?
Force clear cache?
Retrieval method
Build-timeout Plugin > BuildStep Action
?
Git plugin
Global Config user.name Value?
Global Config user.email Value?
?
?
?
?
?
?
?
Shell
Shell executable?
Extended E-mail Notification
SMTP server
SMTP Port
Edited
Credentials
Use SSL
Use TLS
Use OAuth 2.0
Advanced Email Properties
Default user e-mail suffix?
Edited
Charset
Additional accounts
Account
Admin Account Address
SMTP server
SMTP Port
Edited
Credentials
Use SSL
Use TLS
Use OAuth 2.0
Advanced Email Properties
Default Content Type?
List ID?
Add 'Precedence: bulk' E-mail Header?
Default Recipients?
Reply To List?
Emergency reroute?
Allowed Domains?
Excluded Recipients?
Default Subject?
Maximum Attachment Size?
Default Content?
Default Pre-send Script?
Default Post-send Script?
Additional groovy classpath?
Enable Throttling?
Enable Debug Mode?
Require Administrator for Template Testing?
Enable watching for jobs?
Allow sending to unregistered users?
Edited
Default Triggers?





















Content Token Reference?
E-mail Notification
SMTP server
Default user e-mail suffix?
Edited
?
User Name
Password
Use SSL?
Use TLS
SMTP Port?
Reply-To Address
Charset
Test e-mail recipient