WARNING: Jenkins X version 2.x is unmaintained. Do not use it.
Please refer to the v3 documentation for the latest supported version.
Jenkins X should work out of the box with smart defaults for your cloud provider. e.g. Jenkins X automatically uses ECR if you are using AWS or EKS.
However you can configure values in the underlying helm charts used by Jenkins X.
Making changes after the install
Once you have installed you can make more changes via jx upgrade platform which will reuse your
Or if you use GitOps management you can just create a Pull Request on your Development environment git repository.
e.g. if you wish to disable Nexus being installed and instead service link to a separate nexus at a different host name you can use this
nexus: enabled: false nexusServiceLink: enabled: true externalName: "nexus.jx.svc.cluster.local"
To disable and service link chart museum add:
chartmuseum: enabled: false chartmuseumServiceLink: enabled: true externalName: "jenkins-x-chartmuseum.jx.svc.cluster.local"
We ship with a default Jenkins docker image jenkinsxio/jenkinsx with Jenkins X which has all of our required plugins inside.
If you wish to add your own plugins you can create your own
Dockerfile and image using our base image like this:
# Dockerfile for adding plugins to Jenkins X FROM jenkinsxio/jenkinsx:latest COPY plugins.txt /usr/share/jenkins/ref/openshift-plugins.txt RUN /usr/local/bin/install-plugins.sh < /usr/share/jenkins/ref/openshift-plugins.txt
Then add your custom plugins to
plugins.txt locally of the form:
Once you have built and released your image via CI/CD you can then use it in your Jenkins X installation.
To configure Jenkins X to use your custom image you can specify your own Jenkins image via a
jenkins: Master: Image: "acme/my-jenkinsx" ImageTag: "1.2.3"
There is an example OSS project jenkins-x/jenkins-x-openshift-image you could use as a template which creates a new Jenkins image to add OpenShift specific plugins and configuration for using Jenkins X on OpenShift.
We try and use the best defaults for each platform for the Docker Registry; e.g. using ECR on AWS.
jx create cluster gke --docker-registry eu.gcr.io
Though if you use a different Docker Registry you will probably need to also modify the secret for connecting to docker.
Was this page helpful?
Glad to hear it! Please tell us how we can improve.
Sorry to hear that. Please tell us how we can improve.