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. You must reserve ports for Artifactory and set up the required database for Artifactory.
Installation Types
The install type is referenced as <type> in the different installation instructions.
Subscription Type | Install Type | Download the Package |
|---|---|---|
Pro, Pro X, Enterprise X, Enterprise+ | pro | |
Artifactory OSS | oss | |
JFrog Container Registry | jcr | |
Artifactory Community Edition for C/C++ | cpp-ce |
Installation Steps
The installation procedure involves the following main steps:
Download the relevant package from the JFrog Platform Downloads page to install (Linux Archive, Docker Image, Docker Compose, RPM, Debian, Helm, Windows).
Install Artifactory either as a single node installation or a high availability cluster.
Customize the product configuration (optional) including database, Java Opts, and filestore.
Start the service using the start scripts or OS service management.
Check the Artifactory Log to check the status of the service.
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:
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.
Make sure you have completed 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.
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. The load balancer should be installed once all of the cluster nodes are up and running. It is the responsibility of your organization to manage and configure it correctly.
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.