Artifactory Installation

You can install and configure JFrog Artifactory in both single-node and high-availability modes.

📘

Note

Use a dedicated server with no other software running to alleviate performance bottlenecks, avoid port conflicts, and avoid setting uncommon configurations.

📘

Artifactory on Amazon ECS

You can install Artifactory on Amazon ECS as a single-node installation. On Amazon ECS, you are limited to a 16 vCPUs instance, and you cannot connect or use other JFrog products like Xray or Distribution.

For more information about the JFrog Platform Deployment, see System Architecture.

Before installing Artifactory, see System Requirements for information on supported platforms, supported browsers, and other requirements. Reserve ports for Artifactory and set up the required database.

Installation Types

The install type is referenced as <type> in the different installation instructions.

Installation Steps

The installation procedure involves the following main steps:

1. Download the relevant package from the JFrog Platform Downloads page to install (Linux Archive, Docker Image, Docker Compose, RPM, Debian, Helm, Windows).
2. Install Artifactory either as a single node installation or a high availability cluster.
3. Customize the product configuration (optional) including database, Java Opts, and filestore.
4. Start the service using the start scripts or OS service management.
5. Check the Artifactory Log to check the status of the service.
6. Implement post installation steps including changing the default password.

If necessary, refer to this Knowledge Base Article to resolve common issues that may occur during installation or upgrade.

📘

Default Home Directory / $JFROG_HOME

The default home directory is defined according to the installation type. For more information, see System Directories.

$JFROG_HOME represents the JFrog root directory containing the deployed product.

Artifactory Single Node and HA Installations

The following installation methods are supported:

• Helm on Kubernetes environment
• Helm on OpenShift environment
• Docker Compose
• Docker
• RPM
• Debian
• Linux Archive
• Windows

Prerequisites to run Artifactory HA

Ensure that your environment meets the following prerequisites:

• Version: All nodes within the same Artifactory HA installation must be running the same version of Artifactory.

• Database: Artifactory HA requires an external database, and currently supports the following databases: PostgreSQL, Oracle, MySQL, and Microsoft SQL Server.

  Complete setting up your external database before proceeding to install the cluster nodes. The database connection details are used for each node installation.

• Licensing: Artifactory HA is supported with an Enterprise X, Enterprise+, and Edge License. Each node in the cluster must be activated with a different license.

• Load Balancer: Artifactory HA requires a dedicated Load Balancer, installed after all cluster nodes are running. See Load Balancer for configuration requirements.

• Network: All the Artifactory HA components (Artifactory cluster nodes, database server, and load balancer) must be within the same fast LAN.

  All the HA nodes must communicate with each other through dedicated TCP ports.

  Network communications between the cluster nodes must be enabled for each of the nodes.

Installation Methods