You can install and configure JFrog Artifactory in both single node and high availability modes. For additional information on high availability, see high availability.
Note
Use a dedicated server with no other software running to alleviate performance bottlenecks, avoid port conflicts, and avoid setting uncommon configurations.
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
Artifactory on Amazon ECS
You can install Artifactory on Amazon ECS as a single node installation. On Amazon ECS, you are limited to a 4 CPU instance and you cannot connect or use other JFrog products like Xray or Distribution.
To learn about the JFrog Platform Deployment, see System Architecture.
Before You Begin
Before installing Artifactory, see System Requirements for information on supported platforms, supported browsers, and other requirements. You must set aside ports that are reserved for Artifactory and set up the required database for Artifactory.
ARM64 Support
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.
Installation Steps
The installation procedure involves the following main steps.
Download the relevant package from the Download JFrog Platform page, according to the above table, 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.
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.
Did you know?
You can also deploy the JFrog products with different Cloud providers and multiple orchestration tools. For more information, see JFrog Partner Integrations.
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 Single Node Installation
The following installation methods are supported.
Artifactory HA Installation
Artifactory supports installation in an HA cluster. For more information about HA, see JFrog High Availability.
Note
HA versions before Artifactory 7.17.4 support using primary and secondary nodes.
The following installation methods are supported.
HA is not supported for Mac (Darwin) installation
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 Artifactory version.
Database
Artifactory HA requires an external database, and currently supports the following databases: PostgreSQL, Oracle, MySQL, and MS SQL.
Make sure you have completed setting up your external databasebefore proceeding to install the cluster nodes. The database connection details are used for each node installation.
Licensing
Artifactory HA is supported with an Enterprise License. Each node in the cluster must be activated with a different license.
Before adding any additional node, please add each additional node's license using the node that is already running.
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.
Note
Use a dedicated server with no other software running to alleviate performance bottlenecks, avoid port conflicts, and avoid setting uncommon configurations.
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.