You can install and configure Pipelines on a single node and in a high availability cluster. For more information on high availability, see High Availability.
Before installing Pipelines 1.x, you must first install JFrog Artifactory 7.x. JFrog Pipelines requires a JFrog Artifactory instance with an Enterprise+ license.
Use a dedicated server with no other software running to alleviate performance bottlenecks, avoid port conflicts, and avoid setting uncommon configurations.
To learn about the JFrog Platform Deployment, refer to System Architecture.
Admin Permissions for Installation
We recommend that you run the installation as a root user or provide sudo access to a non-root user.
You need to have admin permissions on the installation machine in the following cases.
Native installer - always requires admin permissions
Archive installer - requires admin permissions only during installation
Docker installer - does not require admin permissions
Ensure that your environment has OpenSSL before you start the installation.
Run the following command to install OpenSSL.
sudo apt-get install openssl
sudo yum install -y openssl
Before you proceed, see System Requirements for information on supported platforms, supported browsers, and other requirements.
Pipelines makes use of the Artifactory filestore for performing storage functions such as step caching.
Operating Systems and Platform Support
The following table lists the supported operating systems and the versions.
7.x, 8.x, 9.x
18.04, 20.04, 22.04
Build nodes only
Amazon Linux 2023, Amazon Linux 2
Breaking Change Affecting RPM/Yum/Linux Archive Installations on Centos 7.x*
As part of our commitment to our customers to maintain the security and reliability of your JFrog Platform, from Artifactory version v7.43.x, JFrog Artifactory will officially run with JDK 17 and Tomcat 9.x on all installation types. Note that JDK 17 and Tomcat 9.x are not supported on all Centos 7.x versions.
CentOS 8.x Support
CentOS 8.x reached its end-of-life in December 2021. CentOS 8.x support for JFrog products has been deprecated by the end of June 2022.
The following table lists the supported platforms.
Installation on Kubernetes environments is through Helm Charts. Supported Helm version is Helm 3+.
From version 7.41.4, Artifactory supports installation on ARM64 architecture through Helm and Docker installations. You must set up an external database as the Artifactory database since Artifactory does not support the bundled database with the ARM64 installation. Artifactory installation pulls the ARM64 image automatically when you run the Helm or Docker installation on the ARM64 platform.
ARM64 support is also available for Xray, Distribution, and Insight. ARM64 support is not available for Pipelines.
Database and Third-Party Applications in Pipelines
For a single node installation of Pipelines, the PostgreSQL database is by default installed on the same node as Pipelines. It may be optionally configured as an external database.
Pipelines HA requires an external database for common use by all HA nodes.
Pipelines supports the following versions of PostgreSQL.
Pipelines uses Redis 6.2.6 and bundles a Redis package along with the installer.
RabbitMQ 3.8 is installed as part of the Pipeline installation for every node In case of HA architecture, it uses queue mirroring between the different RabbitMQ nodes. You should not use any other external RabbitMQ instance.
Pipelines Network Ports
Pipelines uses the 8082 port and 30001 (30200 from Pipelines 1.0 to 1.10.0) by default for external communication.
Pipelines uses the following internal ports by default for communication with JFrog Platform microservices.
Pipelines WWW (UI)
SSH access to the instance
Database (PostgreSQL) access
6379, 16379, 6380, 16380, 6381, 16381
The installation procedure involves the following main steps:
Download Pipelines as per your required installer type (Linux Archive, RPM, Debian, Helm).
Install Pipelines either as a single node installation, or high availability cluster.
Install third-party dependencies (PostgreSQL and Elasticsearch databases, included in the archive)
Configure the service
Connection to Artifactory (
Additional optional configuration including changing default credentials for databases
Start the Service using the start scripts or OS service management.
Check the Service Log to check the status of the service.
Default Home Directory / $JFROG_HOME
The default Xray home directory is defined according to the installation type. For additional details see the Product Directory Structure page.
$JFROG_HOME represents the JFrog root directory containing the deployed product.
Pipelines Single Node Installation
Choose one of the following methods for installing Pipelines in a single node.
Pipelines HA Installtion
You can also install Pipelines in HA mode. For more information, see Pipelines HA Installation