Artifactory Linux Package Installation
Install Artifactory on Linux using RPM, Debian, or Linux archive for single-node and HA deployments.
Installing JFrog Artifactory on Linux uses your operating system's package manager (YUM, DNF, or APT) or a self-contained archive to install and configure Artifactory and its dependencies. It works for both single-node and high-availability (HA) deployments.
Tip
To simplify installation, try the Artifactory Install Helper, which walks you through configuring and setting up Artifactory interactively. The instructions for each installation method below cover the same process in detail.
Choose your environment below to get started:
- Install Artifactory on RPM-based systems (RHEL, CentOS, Fedora)
- Install Artifactory on Debian-based systems (Debian, Ubuntu)
- Install Artifactory with a Linux Archive (All Linux)
Prerequisites
These prerequisites apply to all three installation methods.
-
Confirm your OS is a JFrog-supported OS.
-
Before installing, run a preflight check using the
diagnosticUtilutility to confirm your VMs meet the minimum resource requirements. -
Configure your network to meet JFrog's network requirements.
-
For additional prerequisites such as Java requirements and supported browsers, see:
Related Topics
- Artifactory Installation
- Artifactory System Requirements
- Database Configuration
- Filestore Configuration
- Upgrading Artifactory
- Artifactory Docker Installation
- Artifactory Installation with Helm Charts
Frequently Asked Questions
This section provides answers to frequently asked questions.
FAQs
Q: Do I need to run a preflight check before installing Artifactory?
A: Yes. Before installing, run a preflight check using the diagnosticUtil utility to confirm your VMs meet the minimum resource requirements. You must also confirm your OS is a JFrog-supported OS and configure your network to meet JFrog's network requirements.
Q: What database is recommended for a production Artifactory installation?
A: JFrog highly recommends using PostgreSQL for all products in the JFrog Platform, although Artifactory supports additional databases. Configure the database connection in $JFROG_HOME/artifactory/var/etc/system.yaml on each Artifactory node. For full setup details, see Database Configuration.
Q: What happens if I start additional HA nodes before applying their licenses?
A: The front-end microservices on those nodes may fail to start with the error [jfrt] [WARN] ... - License is not installed. Apply licenses for all nodes through the first node's UI before starting any additional nodes.
Q: Why must I copy the master.key to all HA nodes before starting them?
master.key to all HA nodes before starting them?A: The first Artifactory node generates the master.key during initialization. All other nodes in the cluster must have this file copied from $JFROG_HOME/artifactory/var/etc/security/ on the first node to the identical path on each remaining node before starting those nodes, or the cluster will not form correctly.
Q: How do I confirm that Artifactory is running after installation?
A: For RPM and Debian installations, and for a Linux archive installed as a systemd service, run sudo systemctl status artifactory.service to check the service status. For a Linux archive installed as an init.d service, run sudo service artifactory status. For a Linux archive running as a process, run ./artifactoryctl check from $JFROG_HOME/artifactory/app/bin. You can also open your browser and navigate to http://<ARTIFACTORY_NODE_IP>:8082/ to access the Artifactory UI, where you will be guided through the onboarding wizard on first access.
Updated 12 days ago
