Installing on Linux

CloudBees distributes a number of native packages for CloudBees Jenkins Distribution on Linux. These native packages automatically install system dependencies, such as a Java runtime environment, set up init.d scripts for running the CloudBees Jenkins Distribution service, and configure the /var/log/cloudbees-jenkins-distribution logging directory.

For each supported Linux distribution, a repository and key must be imported before CloudBees Jenkins Distribution can be installed on the desired Linux machine using this repository.

Red Hat Enterprise Linux, CentOS, Fedora

Administrators running Red Hat-based distributions, such as Red Hat Enterprise Linux, Fedora, Oracle Linux, and CentOS, first need to set up the RPM repository for CloudBees Jenkins Distribution and import the key.

  1. Set up the RPM repository:

    sudo wget -O /etc/yum.repos.d/cloudbees-jenkins-distribution.repo https://downloads.cloudbees.com/cloudbees-jenkins-distribution/rolling/rpm/cloudbees-jenkins-distribution.repo
  2. Import the CloudBees key:

    sudo rpm --import https://downloads.cloudbees.com/cloudbees-jenkins-distribution/rolling/rpm/cloudbees.com.key
    Note

    If the CloudBees key has already been imported on the machine, the rpm --import command will fail. This error can be safely ignored.

  3. Once the repository and key have been set up, CloudBees Jenkins Distribution can be installed with yum via:

    sudo yum install cloudbees-jenkins-distribution
  4. Set the cloudbees-jenkins-distribution service to automatically start on boot:

    sudo chkconfig --add cloudbees-jenkins-distribution
    sudo /etc/init.d/cloudbees-jenkins-distribution start

After the process has completed, CloudBees Jenkins Distribution service should start automatically and be available in a web browser at localhost:8080 by default.

The setup process can be done using the Getting Started wizard.

Debian and Ubuntu

Administrators running Debian-based distributions such as Debian or Ubuntu will need to add an APT repository and key in order to install CloudBees Jenkins Distribution.

  1. To use the Debian package repository of CloudBees Jenkins Distribution to automate installation and upgrade, first add the key to your system:

    wget -q -O - https://downloads.cloudbees.com/cloudbees-jenkins-distribution/rolling/debian/cloudbees.com.key | sudo apt-key add -
  2. Edit /etc/apt/sources.list and add the entry for CloudBees Jenkins Distribution:

    deb https://downloads.cloudbees.com/cloudbees-jenkins-distribution/rolling/debian binary/
  3. Update your local package index:

    sudo apt-get update
  4. Install CloudBees Jenkins Distribution:

    sudo apt-get install cloudbees-jenkins-distribution
    Caution

    Older versions of Debian and Ubuntu do not provide a Java 8 package and CloudBees Jenkins Distribution may fail to install as a result. Using newer versions of these distributions which provide Java 8 is strongly recommended.

  5. Start the cloudbees-jenkins-distribution service:

    service cloudbees-jenkins-distribution start

After the process has completed, CloudBees Jenkins Distribution service should start automatically and be available in a web browser at localhost:8080 by default.

The setup process can be done using the Getting Started wizard.

openSUSE and SUSE Linux

Use the zypper command to install CloudBees Jenkins Distribution on openSUSE-based distributions.

  1. First, add the CloudBees RPM repository:

    sudo zypper addrepo -f https://downloads.cloudbees.com/cloudbees-jenkins-distribution/rolling/opensuse/ cloudbees-jenkins-distribution
  2. Next, run:

    sudo zypper install cloudbees-jenkins-distribution

After the process has completed, CloudBees Jenkins Distribution service should start automatically and be available in a web browser at localhost:8080 by default.

The setup process can be done using the Getting Started wizard.