Install CloudBees CD/RO on traditional platforms

4 minute readReference

This section describes the resources for installing CloudBees CD/RO in on-premise traditional environments.

For information on upgrading CloudBees CD/RO, refer to Upgrade on traditional platforms.

CloudBees CD/RO components

Traditional CloudBees CD/RO environments typically consist of the following components:

For production environments, CloudBees recommends installing each CloudBees CD/RO component on separate machines. Additionally, there are specific agent security recommendation that can be found on Agent security recommendations.
  • CloudBees CD/RO server

  • CloudBees CD/RO agents

  • CloudBees CD/RO web server

  • CloudBees CD/RO repository

  • CloudBees Tools

  • External database

    CloudBees CD/RO installers include a built-in MariaDB database to aid in quick setup, but only for evaluation purposes. These types of installations have very limited capabilities, and are not feasible for production.

    For production environments, you must install an external database, which requires a CloudBees CD/RO enterprise license. For more information on licenses, contact CloudBees support.

    For more information on which databases are supported, refer to Supported platforms for CloudBees CD/RO on traditional platforms. For more information on how to configure an external database, refer to Configure an external database.

  • CloudBees Analytics

    CloudBees Analytics is an optional component that allows you to collect and visualize data about CloudBees CD/RO jobs. CloudBees Analytics is installed seperate from CloudBees CD/RO using a standalone installer.

For traditional installations:

  • All CloudBees CD/RO components can be installed on dedicated hardware or virtual machines running supported versions of Linux and Windows using the full installers.

  • Agents can be installed using the full installer or the standalone installer on machines running supported versions of Linux, Windows, macOS, and Linux ARM.

  • CloudBees Tools can be installed using the full installer or from archive files on machines running supported versions of Linux, Windows, macOS, and Linux ARM.

  • CloudBees Analytics can be installed on dedicated hardware or virtual machines running supported versions of Linux or Windows using the standalone installer.

For more information on supported platforms, refer to Supported platforms for CloudBees CD/RO on traditional platforms.

You can download all CloudBees CD/RO installers from CloudBees Downloads. The following sections provide platform-specific information for installers for each operating system.

Windows installers

The following traditional CloudBees CD/RO installers are available for Windows.

For Windows installations, all installers must be run using an Administrator user. For more information, refer to Windows services user permissions.
Type What the installer does Download latest

Full installer

Installs all CloudBees CD/RO components, including a server, web server, repository server, agents, and CloudBees Tools. It includes options to install a built-in database or configure an external database.

The full installer includes options to install all components on the same machine for development and testing purposes, or to install individual components on separate machines for production environments.

Agent installer

Installs CloudBees CD/RO agents for running jobs on managed hosts.

Before installing CloudBees CD/RO agents, CloudBees strongly recommends reviewing Agent security recommendations.

CloudBees Analytics installer

Installs CloudBees Analytics.

CloudBees Tools

Installs client binaries used to interact with the CloudBees CD/RO server.

For more information about CloudBees Tools, refer to CloudBees Tools installation.

Linux installers

The following traditional CloudBees CD/RO installers are available for Linux.

For Linux installations, all installers can be run using a root, sudo, or non-root user. For more information, refer to Linux services user permissions.
Type What the Installer Does Download latest

Full installer

Installs all CloudBees CD/RO components, including a server, web server, repository server, agents, and CloudBees Tools. It includes options to install a built-in database or configure an external database.

The full installer includes options to install all components on the same machine for development and testing purposes, or to install individual components on separate machines for production environments.

Agent installer

Installs CloudBees CD/RO agents for running jobs on managed hosts.

Before installing CloudBees CD/RO agents, CloudBees strongly recommends reviewing Agent security recommendations.

CloudBees Analytics installer

Installs CloudBees Analytics.

CloudBees Tools

Installs client binaries used to interact with the CloudBees CD/RO server. For more information about CloudBees Tools, refer to CloudBees Tools installation.

Linux ARM installers

The following traditional CloudBees CD/RO installers are available for Linux ARM.

For Linux ARM, the agent installer can be run using a root, sudo, or non-root user. For more information, refer to Linux ARM services user permissions.
Type What the Installer Does Download latest

Agent installer

Installs CloudBees CD/RO agents for running jobs on managed hosts.

Before installing CloudBees CD/RO agents, CloudBees strongly recommends reviewing Agent security recommendations.

CloudBees Tools

Installs client binaries used to interact with the CloudBees CD/RO server. For more information about CloudBees Tools, refer to CloudBees Tools installation.

macOS installers

The following traditional CloudBees CD/RO installers are available for macOS.

For macOS, the agent installer can be run using a root, sudo, or non-root user. For more information, refer to install-user-reqs.adoc#macos-service-user-permissions.
Type What the installer does Download latest

Agent installer

Installs CloudBees CD/RO agents for running jobs on managed hosts.

Before installing CloudBees CD/RO agents, CloudBees strongly recommends reviewing Agent security recommendations.

CloudBees Tools

Installs client binaries used to interact with the CloudBees CD/RO server. For more information about CloudBees Tools, refer to CloudBees Tools installation.