--- title: Charmhub | Deploy Jenkins using Charmhub - The Open Operator Collection description: Deploy the latest version of Jenkins on any cloud. url: https://charmhub.io/jenkins/configurations --- # Jenkins [Charm CI/CD team](https://charmhub.io/publisher/cicd "View all packages from Charm CI/CD team") * [Charm CI/CD team](https://charmhub.io/publisher/cicd "View all packages from Charm CI/CD team") * [Monitoring](https://charmhub.io/?filter=monitoring) Platform: 20.04 18.04 16.04 stable 4ebe020 ``` juju deploy jenkins ``` [Learn to deploy on juju >](https://juju.is/docs/juju/manage-applications) * [bundle-site](https://charmhub.io/jenkins/configurations#bundle-site) * [extra\_packages](https://charmhub.io/jenkins/configurations#extra_packages) * [install\_keys](https://charmhub.io/jenkins/configurations#install_keys) * [install\_sources](https://charmhub.io/jenkins/configurations#install_sources) * [jnlp-port](https://charmhub.io/jenkins/configurations#jnlp-port) * [master-executors](https://charmhub.io/jenkins/configurations#master-executors) * [no-proxy](https://charmhub.io/jenkins/configurations#no-proxy) * [package\_status](https://charmhub.io/jenkins/configurations#package_status) * [password](https://charmhub.io/jenkins/configurations#password) * [plugins](https://charmhub.io/jenkins/configurations#plugins) * [plugins-auto-update](https://charmhub.io/jenkins/configurations#plugins-auto-update) * [plugins-auto-update-interval](https://charmhub.io/jenkins/configurations#plugins-auto-update-interval) * [plugins-check-certificate](https://charmhub.io/jenkins/configurations#plugins-check-certificate) * [plugins-site](https://charmhub.io/jenkins/configurations#plugins-site) * [proxy-hostname](https://charmhub.io/jenkins/configurations#proxy-hostname) * [proxy-password](https://charmhub.io/jenkins/configurations#proxy-password) * [proxy-port](https://charmhub.io/jenkins/configurations#proxy-port) * [proxy-username](https://charmhub.io/jenkins/configurations#proxy-username) * [public-url](https://charmhub.io/jenkins/configurations#public-url) * [release](https://charmhub.io/jenkins/configurations#release) * [remove-unlisted-plugins](https://charmhub.io/jenkins/configurations#remove-unlisted-plugins) * [tools](https://charmhub.io/jenkins/configurations#tools) * [update-center](https://charmhub.io/jenkins/configurations#update-center) * [update-center-ca](https://charmhub.io/jenkins/configurations#update-center-ca) * [username](https://charmhub.io/jenkins/configurations#username) [Learn about configurations >](https://juju.is/docs/juju/configuration#heading--application-configuration) * bundle-site | string Site to download deb packages from when installing jenkins from bundle. If this configuration is not set, the jenkins deb package needs to be manually copied over to the charm files/ dir before deployment and named jenkins.deb. * extra\_packages | string Space separated list of extra deb packages to install. * install\_keys | string List of signing keys for install\_sources package sources, per charmhelpers standard format (a yaml list of strings encoded as a string). The keys should be the full ASCII armoured GPG public keys. While GPG key ids are also supported and looked up on a keyserver, operators should be aware that this mechanism is insecure. null can be used if a standard package signing key is used that will already be installed on the machine, and for PPA sources where the package signing key is securely retrieved from Launchpad. * install\_sources | string List of extra apt sources, per charm-helpers standard format (a yaml list of strings encoded as a string). Each source may be either a line that can be added directly to sources.list(5), or in the form ppa:/ for adding Personal Package Archives, or a distribution component to enable. * jnlp-port | int Default: 48484 TCP port on which to listen for incoming connections from slaves. Set to 0 for a random port, or to -1 to disable JNLP entirely. * master-executors | int Default: 1 Number of executors to configure for jenkins master. * no-proxy | string If a proxy is configured but some hosts should not go through the proxy, set the hostnames here. Ignored if any of the proxy settings above are not set. Separated by commas. "*" is the wild card host name(such as "*.jenkins.io" or "www\*.jenkins-ci.org"). * package\_status | string Default: install The status of service-affecting packages will be set to this value in the dpkg database. Valid values are "install" and "hold". * password | string Admin user password, will be auto-generated if not set. Can be retrieved via the get-admin-credentials action. This is used to manage slave nodes so please don't change in Jenkins. * plugins | string Space separated list of plugins to install * plugins-auto-update | boolean This option enables auto update for plugins. The routine will check for new versions available based on Update Center's info, will update them through jenkins and safe-restart once completed. * plugins-auto-update-interval | int Default: 1440 Interval which the auto-update will try to run (in minutes). * plugins-check-certificate | string Default: yes Set to no to allow downloading from an invalid https site. * plugins-site | string Default: https://updates.jenkins-ci.org/latest/ Site to download plugin .hpi files from. * proxy-hostname | string If a proxy is required for Jenkins to download plugins and updates, set its hostname or IP address here, e.g. "proxy.example.tld" or "10.0.0.1". * proxy-password | string If a proxy is required for Jenkins to download plugins and updates and authentication is also required, set the password here. Ignored if proxy-hostname and proxy-password are not both also set. * proxy-port | int Default: 3128 If a proxy is required for Jenkins to download plugins and updates, set its port number here. Ignored if proxy-hostname is not also set. * proxy-username | string If a proxy is required for Jenkins to download plugins and updates and authentication is also required, set the username here. Ignored if proxy-hostname is not also set. * public-url | string Public url of Jenkins frontend, including the hostname and prefix. This is used by Jenkins whenever generating full links. * release | string Default: lts Source of Jenkins, options include: - lts: use the most recent Jenkins LTS release. - trunk: use the most recent Jenkins release. - bundle: use a bundled deb package. The bundle-site configuration should be set or the jenkins deb package needs to be manually copied over to the charm files/ dir before deployment and named jenkins.deb. It can be downloaded from http://pkg.jenkins-ci.org/debian/ - http(s)://...: http(s) link to a retrievable jenkins deb * remove-unlisted-plugins | string Default: no Set this to yes to remove any plugins not listed in plugins from the installation. * tools | string Default: git gcc make bzr Tooling to deploy alongside jenkins * update-center | string Configure a custom Update Center instead of getting plugins from updates.jenkins-ci.org. Provide the whole path to update-center.json file. Example: https://your-domain.com/current/update-center.json * update-center-ca | string CA certificate for the update-center. This is required when setting update-center because jenkins won't be able to validate your custom Update Center without it. * username | string Default: admin Admin user username - used to manage slave nodes so please don't change in Jenkins.