Documentation
Software Delivery Automation
CloudBees Software Delivery Automation CloudBees CI CloudBees CD/RO CloudBees Previews
Other CloudBees Products
CloudBees Build Acceleration CloudBees CodeShip
Cloud-Native Platform
CloudBees platform CloudBees Feature Management (legacy)
Resources
Account management Legal and policies
Training
Support
Plugins
CloudBees CI Plugins CloudBees CD/RO Plugins
Lexicon
CloudBees CI CloudBees CD/RO CloudBees platform CloudBees Feature Management (legacy)CloudBees Build Acceleration
AI HelpBeta
Search
Enable dark mode
New to CloudBees or returning.
Sign in / Sign up

Resources

Account management Legal and policies

Software Delivery Automation

CloudBees Software Delivery Automation CloudBees CI CloudBees CD/RO CloudBees Previews

Cloud-Native Platform

CloudBees platform CloudBees Compliance CloudBees Feature Management (legacy)

Other CloudBees Products

CloudBees Build Acceleration CloudBees CodeShip

Documentation API reference Migration guides Lexicon Release notes Knowledge Base

latest (2.504.1.6)2.492.3.5 2.492.2.3 2.492.2.2 2.492.1.3 2.479.3.2 2.479.3.1 2.479.2.3 2.479.1.4 2.479.1.3 2.462.3.3 2.462.2.2 2.462.1.3 2.452.3.2 2.452.2.4 2.452.2.3 2.452.1.2 2.440.3.8 2.440.3.7

Introduction Multicloud environment

Introduction CI as code Contextual pipeline feedback CloudBees CI ServiceNow integration

Introduction Modernized pipelines Secure CI/CD Velero for backup and restore

Introduction Enterprise team management and authorization

Introduction Optimize Continuous Integration Resources Enterprise Grade Plugin Management Plugin Usage Analyzer High Availability and Horizontal Scalability Debug Pipelines at Scale

Onboarding for modern cloud platforms

Onboarding for traditional platforms

Train your team

Architecture for modern cloud platforms

Architecture for traditional platforms

Feature comparison

Supported platforms for CloudBees CI on modern cloud platforms Supported platforms for CloudBees CI on traditional platforms

Modern cloud platforms

Traditional platforms

Introduction Pre-installation requirements Install Verify Docker images Uninstall

Introduction Pre-installation requirements Install Verify Docker images Uninstall

Introduction Pre-installation requirements Install Verify Docker images Uninstall

Introduction Pre-installation requirements Install Verify Docker images Uninstall

Introduction Pre-installation requirements Install Verify Docker images Uninstall

Introduction Pre-installation requirements Install Verify Docker images Uninstall

Introduction System requirements Verify Docker images Install operations center Install client controllers Verify build components Verify WAR files

Introduction HA fundamentals Get ready for HA Install HA on modern cloud platforms Install HA on traditional platforms HA considerations High Availability (active/passive) installation for CloudBees CI on traditional platforms

Introduction What is FIPS and FIPS 140 compliance?Install CloudBees CI on modern cloud platforms in FIPS mode CAP plugin support in a FIPS 140-3 environment Configure the Apache™ Ant plugin for FIPS compliance Configure the Pipeline Maven API plugin for FIPS compliance Known FIPS incompatibilities with CloudBees CI on modern cloud platforms Jenkins core: FIPS 140-3 compliant artifacts with caveats Jenkins core: Non-compliant classes and libraries

Introduction Migrate to Java 11 Migrate to Java 17 Migrate to Java 21 Migrate historical User Activity Monitoring Plugin data

Introduction Migrate to Java 11 Migrate to Java 17 Migrate to Java 21 Migrate historical User Activity Monitoring Plugin data

Configure features using Manage Jenkins

Use CloudBees CI Teams

Add external client controllers

Set up agents on CloudBees CI

Use WebSockets to connect controllers to the operations center

Deploy CloudBees CI across multiple Kubernetes clusters

Add custom header labels to CloudBees CI

Connect inbound agents

Set up HTTPS for GKE

Best practices when building container images

Connect a client controller to operations center

Disconnect a client controller from operations center

Plugin management

Getting started with plugin management

CloudBees Assurance Program

Beekeeper Upgrade Assistant

Adding Beekeeper plugin exceptions

Finding the support tier for a plugin

Installing plugins

Upgrading plugins from the Plugin Manager

Uninstalling plugins

Disabling plugins

Reviewing plugin usage

Configuring plugin catalogs

Managing plugins with Update Center

Managing plugins in a secure environment

Introduction Pipeline terms Pipeline project types CloudBees Pipeline benefits

Introduction Using Pipeline development utilities Determining plugin compatibility Pipeline best practices

Introduction Prerequisites Creating your first Pipeline Selecting agents Creating Pipelines in SCM Creating Pipelines in Web UI Using Pipeline as Code

Introduction Config Adv Scripted Config Build Stage Config Deploy Stage Config Optional Step Args Config Test Stage Creating Jenkinsfile Customizing Parameters Handling Failures String Interpolation Using Multiple Agents Working With The Env Reusing Configuration Files

Introduction Managing artifacts Tracing artifacts Triggering jobs with a simple webhook Restoring files Visualizing Pipeline Inserting checkpoints Securing Pipelines Configuring Pipelines with user-scoped credentials Using Pipeline Policies Specifying a matrix of one or more dimensions Converting a Freestyle project to a Declarative Pipeline Pipeline builds and HA (active/active)

Introduction Restarting aborted builds Long-running builds Skip next build Consolidated Build View plugin CloudBees Quiet Start plugin CloudBees Template plugin CloudBees Workspace Caching

Introduction Trigger a job with a notification event using Cross Team Collaboration Enable external notification events with external HTTP endpoints Cluster-wide copy artifacts Cluster-wide job triggers

Introduction Setting up a Pipeline Template Catalog Defining Pipeline Template Catalogs Setting Up A Pipeline Template Using parameters in template.yaml Managing multibranch Pipeline options in template.yaml Managing Pipeline Template Catalogs in bulk Example full Maven/Java app Jenkinsfile

Introduction Using Declarative Pipeline syntax Using Scripted Pipeline syntax

Introduction Branch Source Bitbucket GitHub Git Branch Property Strategy Examples

CloudBees Docker Build and Publish plugin CloudBees Docker Traceability Docker Pipeline plugin CloudBees Docker Hub/Registry Notification plugin

Introduction Get started Navigate the operations center interface Provision managed controllers in multiple Kubernetes clusters Provision agents in a separate Kubernetes cluster from a managed controller Provision a controller in a different namespace Provision a controller in a different OpenShift project than the operations center Manage controllers Manage controllers in specific Kubernetes namespaces Migrate an existing managed controller to High Availability (HA)Manage agents Manage SSH credentials Shared agents Shared configurations Shared cloud configuration Trigger restrictions Change NFS storage location Quiet start Move/Copy/Promote Cluster operations Inbound agents Use Kaniko with CloudBees CI Use Buildkit with CloudBees CI Using self-signed certificates in CloudBees CI on Kubernetes Sidecar injector for self-signed certificates on OpenShift Auto-scale nodes on EKS Enable auto-scaling nodes on GKE CloudBees Amazon Web Services Deploy Engine AWS CLI plugin Cloud Foundry CLI Plugin Integrate OpenShift CLI CloudBees CI ServiceNow integration Create projects based on a GitHub repository structure Use GitHub App authentication Create Multibranch Projects and Organization Folders with large repositories WikiText plugin Controller Lifecycle Notifications Plugin

Introduction Get started Navigate the operations center interface Manage client controllers Migrate from High Availability (active/passive) to High Availability (active/active) on CloudBees CI on traditional platforms Managing agents Manage SSH credentials Shared agents Shared configurations Shared cloud configuration Trigger restrictions Quiet start Move/Copy/Promote Cluster operations Inbound agents CloudBees CI ServiceNow integration Create projects based on a GitHub repository structure Use GitHub App authentication Create Multibranch Projects and Organization Folders with large repositories WikiText plugin

Pod Security Admission

Centrally manage security for controllers

CyberArk Credential Provider Plugin

CloudBees HashiCorp Vault Plugin

Enable advanced use cases: Cross-controller triggers and bulk operations

Restrict access and delegate administration with Role-Based Access Control

Example RBAC configurations

Create secure folders with Role-Based Access Control Auto Configurer

Restrict job triggers

Set up operations center-level access controls

Set up access controls on connected controllers

Test the SSH connection to an agent

Configure restricted credentials with the CloudBees Restricted Credentials plugin

Folders Plus plugin

Inject secrets into builds

Manage build agents with the Nodes Plus plugin

Extended security settings

Enhanced credentials masking

Understand Beekeeper security warnings

Prevent unauthorized interaction between builds

Security recommendations

Use single sign-on (SSO) in the operations center

CloudBees CI integration with Microsoft Entra ID

Operations center specific permissions

Authentication mapping

Delegate administration

Data collection for the CloudBees Analytics Plugin

Modern DevOps external secrets management

Replace an expired certificate

List of URLs that need access

Block access to URL patterns using the CloudBees Request Filter Plugin

Serve resources from Jenkins

Verify Helm charts with a signature

Introduction $JENKINS_HOME directory Best practices for backup and restore Back up $JENKINS_HOME manually Backup a Role-Based Access Control configuration Restore backup files manually Restore credentials Configure backups using the CloudBees Backup plugin Schedule backups in the CloudBees Backup plugin Restore backups created with the CloudBees Backup plugin Backup and restore on Kubernetes Backup and restore on AWS Backup and restore Kubernetes cluster resources using Velero Run backups using cluster operations

Introduction Configure multiple client controllers with the Jenkins CLI tool Configure an alias for the Jenkins CLI tool Configure Jenkins CLI tool with non-TrustStore TLS certificates

CloudBees Inactive Items Plugin

Jenkins Health Advisor by CloudBees

CloudBees Pull Request Builder for GitHub plugin

Count and monitor user licenses with the CloudBees User Activity Monitoring plugin

CloudBees CI Catalog Plugin - Catalog tool

Introduction Collect metrics with the CloudBees Prometheus Metrics plugin Create metric-based alerts Elasticsearch Reporter Enable GC logging of controllers

Introduction Example implementation with Datadog

Continuous Integration build audit report

CasC fundamentals

CasC requirements

CasC permissions

Introduction Getting started Creating a bundle Configuring the operations center on modern platforms Configuring the operations center on traditional platforms Retrieving bundles using SCM Updating a bundle Bundle update timing for the operations center Viewing the operations center update log Creating items Configuring RBAC Determining plugin compatibility Troubleshooting

Introduction Getting started Creating a bundle Adding controller bundles to the operations center Updating a bundle Bundle update timing for controllers Viewing the controller update log Configuring bundle availability Setting up a client controller Setting up a managed controller Set up a managed controller using the CasC Bundle Service Creating items Configuring RBAC Determining plugin compatibility Advanced topics Troubleshooting

Plugin management with CasC

Create an alternate plugin download site

CasC CLI commands

Introduction Enable actionable build notifications in GitHub and Bitbucket Configure CloudBees SCM Reporting notifications

Introduction Set up actionable build notifications in Slack Configure CloudBees CI Slack Integration users Configure CloudBees CI Slack Integration notifications

Introduction Set up actionable build notifications in Microsoft Teams Configure Microsoft Teams Integration notifications

Azure Kubernetes Service (AKS)

High Availability (active/passive) installation troubleshooting

High Availability (active/active) troubleshooting

Collect cluster logs

Update Center certificate errors

CloudBees CI JVM troubleshooting

Performance decision tree for troubleshooting

Troubleshoot memory leaks

Troubleshoot file and thread leaks

Kubernetes on AWS EKS

Azure Kubernetes Service (AKS)

Kubernetes on GKE

Kubernetes on AWS

Kubernetes on-premise and OpenShift

Kubernetes on VMware Tanzu Kubernetes Grid Integrated Edition

Traditional platforms

Generate a support bundle

Support policies

Troubleshooting installation

1 minute read

This section provides troubleshooting for CloudBees CI installation.

© CloudBees, Inc. 2010 - 2025

Privacy Policy|Legal Notices|Security