--- updatedAt: 2026-06-07T14:05:02.000Z agentTools: siteIndex: https://docs.jfrog.com/llms.txt projectIndex: https://docs.jfrog.com/installation/llms.txt --- # Artifactory Linux Package Upgrade Upgrade Artifactory on Linux using native packages (RPM/Debian) or Linux Archive. Upgrading Artifactory on Linux using native packages provides a straightforward, production-ready process. This approach utilizes your operating system’s package manager (YUM, DNF, or APT) or a manual archive to manage the upgrade and configuration of Artifactory. Choose your environment below to get started: * [Upgrade Artifactory on RPM-based systems (RHEL, CentOS, Fedora)](#upgrade-artifactory-rpm-package) * [Upgrade Artifactory on Debian-based systems (Debian, Ubuntu)](#upgrade-artifactory-debian-package) * [Upgrade Artifactory with a Linux Archive (All Linux)](#upgrade-artifactory-with-linux-archive) ## Upgrade Artifactory RPM Package This topic provides the steps to upgrade your JFrog Artifactory 7.x instance installed via an RPM package to a newer 7.x version. If you want to upgrade from any version lower than 7.x, see [Upgrading Artifactory from 6.10.x to 7.x](upgrading-from-artifactory-version-6-10-x-onwards-to-7-x). #### Preparation and Pre-Upgrade Checks To ensure a smooth upgrade, consider the following: * **Backup Your Data:** We **strongly recommend** performing a full backup of your Artifactory data directory (`$JFROG_HOME/artifactory/var`) and database before starting the upgrade. This allows recovery in case of unexpected issues. * **Review Release Notes:** Always check the [Artifactory Release Notes](/releases/docs/artifactory-release-notes) for the target version. They may contain critical information, breaking changes, or specific pre-upgrade tasks not covered here. * **Downtime:** In a single-node setup, the Artifactory service is unavailable to users during the upgrade. In High Availability (HA) mode, a rolling upgrade ensures only one node is down at a time, so the service remains available. #### Upgrade Steps The following steps outline how to upgrade your Artifactory single-node installation using either the JFrog RPM repository or a direct `.rpm` package download. 1. **Method 1: Upgrade Using the JFrog RPM Repository** This is the recommended upgrade method because it simplifies the process. 1. **Stop Artifactory:** Before upgrading, stop the Artifactory service. ```bash sudo systemctl stop artifactory.service ``` 2. **Install New Version:** Install the desired Artifactory version. Replace `7.111.11` with your target Artifactory version. ```bash sudo yum install jfrog-artifactory-pro-7.111.11 ``` On newer Fedora or CentOS/RHEL versions, you might use **dnf** instead of **yum**. ```bash sudo dnf install jfrog-artifactory-pro-7.111.11 ``` 3. **Start Artifactory:** Once the package installation is complete, start the Artifactory service. ```bash sudo systemctl start artifactory.service ``` 4. **Verify the Upgrade:** * **Check Status:** Run `sudo systemctl status artifactory.service` to confirm the service is running. * **Access UI:** Access `http://:8082/ui/` in your browser to verify the UI loads. * **Monitor Logs:** Use `tail -f $JFROG_HOME/artifactory/var/log/console.log` to check for any startup errors. 2. **Method 2: Upgrade Using a `.rpm` Package** This method is useful for upgrading to a specific `.rpm` package directly. 1. **Stop Artifactory:** Before upgrading, stop the Artifactory service. ```bash sudo systemctl stop artifactory.service ``` 2. **Download the .rpm Package:** Download the `.rpm` package for the specific Artifactory version you want to install. For example, to download version `7.111.11`: ```bash curl -g -L -O -J 'https://releases.jfrog.io/artifactory/artifactory-pro-rpms/jfrog-artifactory-pro/jfrog-artifactory-pro-7.111.11.rpm' ``` 3. **Install the New Package:** Navigate to the directory where you downloaded the file and use **yum** to install it. This will upgrade your existing installation. ```bash sudo yum install -y ./jfrog-artifactory-pro-7.111.11.rpm ``` 4. **Start Artifactory:** Once the package is installed, start the Artifactory service. ```bash sudo systemctl start artifactory.service ``` 5. **Verify the Upgrade:** * **Check Status:** Run `sudo systemctl status artifactory.service` to confirm the service is running. * **Access UI:** Access `http://:8082/ui/` in your browser to verify the UI loads. * **Monitor Logs:** Use `tail -f $JFROG_HOME/artifactory/var/log/console.log` to check for any startup errors. #### Troubleshooting and Post-Upgrade Notes * **Database Migrations:** During the first startup after an upgrade, Artifactory may run database converters to execute changes in the database schema. ## Upgrade Artifactory Debian Package This topic provides the steps to upgrade your JFrog Artifactory 7.x instance installed via a Debian package to a newer 7.x version. If you want to upgrade from any version lower than 7.x, see [Upgrading Artifactory from 6.10.x to 7.x](upgrading-from-artifactory-version-6-10-x-onwards-to-7-x). #### Preparation and Pre-Upgrade Checks To ensure a smooth upgrade, consider the following: * **Backup Your Data:** We **strongly recommend** performing a full backup of your Artifactory data directory (`$JFROG_HOME/artifactory/var`) and database before starting the upgrade. This allows recovery in case of unexpected issues. * **Review Release Notes:** Always check the [Artifactory Release Notes](/releases/docs/artifactory-release-notes) for the target version. They may contain critical information, breaking changes, or specific pre-upgrade tasks not covered here. * **Downtime:** In a single-node setup, the Artifactory service is unavailable to users during the upgrade. In High Availability (HA) mode, a rolling upgrade ensures only one node is down at a time, so the service remains available. #### Upgrade Steps The following steps outline how to upgrade your Artifactory single-node installation using either the JFrog APT repository or a direct `.deb` package download. 1. **Method 1: Upgrade Using the JFrog APT Repository** This is the recommended upgrade method because it simplifies the process. 1. **Stop Artifactory:** Before upgrading, stop the Artifactory service. ```bash sudo systemctl stop artifactory.service ``` 2. **Update APT Cache and Install New Version:** Update your package list and install the desired Artifactory version. Replace `7.111.11` with your target Artifactory version. ```bash sudo apt-get update && sudo apt-get install jfrog-artifactory-pro=7.111.11 ``` 3. **Start Artifactory:** Once the package installation is complete, start the Artifactory service. ```bash sudo systemctl start artifactory.service ``` 4. **Verify the Upgrade:** * **Check Status:** Run `sudo systemctl status artifactory.service` to confirm the service is running. * **Access UI:** Access `http://:8082/` in your browser to verify the UI loads. * **Monitor Logs:** Use `tail -f $JFROG_HOME/artifactory/var/log/console.log` to check for any startup errors. 2. **Method 2: Upgrade Using a .deb Package** This method is useful for upgrading to a specific `.deb` package directly. 1. **Stop Artifactory:** Before upgrading, stop the Artifactory service. ```bash sudo systemctl stop artifactory.service ``` 2. **Download the .deb Package:** Download the `.deb` package for the specific Artifactory version you want to install. For example, to download version `7.111.11`: ```bash curl -g -L -O -J 'https://releases.jfrog.io/artifactory/artifactory-pro-debs/pool/jfrog-artifactory-pro/jfrog-artifactory-pro-7.111.11.deb' ``` 3. **Install the New Package:** Navigate to the directory where you downloaded the file and use `dpkg` to install it. This will upgrade your existing installation. ```bash sudo dpkg -i jfrog-artifactory-pro-7.111.11.deb ``` 4. **Start Artifactory:** Once the package is installed, start the Artifactory service. ```bash sudo systemctl start artifactory.service ``` 5. **Verify the Upgrade:** * **Check Status:** Run `sudo systemctl status artifactory.service` to confirm the service is running. * **Access UI:** Access `http://:8082/` in your browser to verify the UI loads. * **Monitor Logs:** Use `tail -f $JFROG_HOME/artifactory/var/log/console.log` to check for any startup errors. #### Troubleshooting and Post-Upgrade Notes * **Database Migrations:** During the first startup after an upgrade, Artifactory may run database converters to execute changes in the database schema. ## Upgrade Artifactory with Linux Archive This topic provides the steps to upgrade your JFrog Artifactory 7.x instance installed via a Linux archive to a newer 7.x version. If you want to upgrade from any version lower than 7.x, see [Upgrading Artifactory from 6.10.x to 7.x](upgrading-from-artifactory-version-6-10-x-onwards-to-7-x). #### Preparation and Pre-Upgrade Checks To ensure a smooth upgrade, consider the following: * **Backup Your Data:** We **strongly recommend** performing a full backup of your Artifactory data directory (`$JFROG_HOME/artifactory/var`) and database before starting the upgrade. This allows recovery in case of unexpected issues. * **Review Release Notes:** Always check the [Artifactory Release Notes](/releases/docs/artifactory-release-notes) for the target version. They may contain critical information, breaking changes, or specific pre-upgrade tasks not covered here. * **Downtime:** In a single-node setup, the Artifactory service is unavailable to users during the upgrade. In High Availability (HA) mode, a rolling upgrade ensures only one node is down at a time, so the service remains available. #### Upgrade Steps The following steps outline how to upgrade your Artifactory single-node installation from a Linux Archive. 1. **Log in as a root user.** 2. **Set the JFROG\_HOME variable:** ```bash export JFROG_HOME= ``` 3. **Stop Artifactory:** Navigate to the `bin` directory and stop the service. ```bash cd $JFROG_HOME/artifactory/app/bin ./artifactoryctl stop ``` 4. **Download and Extract the New Archive:** Download the new archive, then extract its contents. Replace `` with your target version. ```bash tar -xvf jfrog-artifactory---linux.tar.gz ``` 5. **Export the JF\_NEW\_VERSION variable:** ```bash export JF_NEW_VERSION= ``` 6. **Replace the existing app folder:** Use the following commands to replace the existing `app` folder with the new one. ```bash # Remove app rm -rf $JFROG_HOME/artifactory/app # Copy new app cp -r $JF_NEW_VERSION/app $JFROG_HOME/artifactory # Remove extracted new version rm -rf $JF_NEW_VERSION # Set permissions chown -R artifactory:artifactory $JFROG_HOME/artifactory/app ``` 7. **Re-install as a Service (if applicable):** If Artifactory was previously installed as a service, reinstall it to ensure the new version starts correctly. Otherwise, a server restart may start the older version of Artifactory. ```bash cd $JFROG_HOME/artifactory/app/bin ./installService.sh ``` 8. **Add your Database Connector (if required):** Add your database connector to `$JFROG_HOME/artifactory/var/bootstrap/artifactory/tomcat/lib` if required. For example, add the MySQL connector before starting Artifactory services if you use a MySQL database. 9. **Start Artifactory:** Start the Artifactory service. ```bash sudo systemctl start artifactory.service ``` Alternatively, you can manage Artifactory using the control script: ```bash $JFROG_HOME/artifactory/app/bin/artifactoryctl start|stop|check ``` 10. **Verify the Upgrade:** * **Access UI:** Access `http://:8082/ui/` in your browser to verify the UI loads. * **Monitor Logs:** Use `tail -f $JFROG_HOME/artifactory/var/log/console.log` to check for any startup errors. #### Troubleshooting and Post-Upgrade Notes * **Database Migrations:** During the first startup after an upgrade, Artifactory may run database converters to execute changes in the database schema. ## Related Topics * [Artifactory Upgrade](upgrading-artifactory) * [Products Upgrade](upgrade) * [Artifactory Helm Upgrade](upgrade-helm-charts) * [Artifactory Docker Upgrade](upgrade-docker) * [Artifactory Upgrade from Version 6.10.x to 7.x](upgrading-from-artifactory-version-6-10-x-onwards-to-7-x) * [System Requirements](system-requirements) ## Frequently Asked Questions This section provides answers to frequently asked questions. ##### Q: Do I need to back up before upgrading? **A:** Yes. The page strongly recommends performing a full backup of your Artifactory data directory (`$JFROG_HOME/artifactory/var`) and database before starting the upgrade, to allow recovery in case of unexpected issues. ##### Q: Is there downtime during the upgrade? **A:** In a single-node setup, the Artifactory service is unavailable to users during the upgrade. In High Availability (HA) mode, a rolling upgrade ensures only one node is down at a time, so the service remains available. ##### Q: Can I use this guide to upgrade from Artifactory 6.x? **A:** No. This guide covers upgrading a 7.x instance to a newer 7.x version only. If you want to upgrade from any version lower than 7.x, see [Upgrading Artifactory from 6.10.x to 7.x](upgrading-from-artifactory-version-6-10-x-onwards-to-7-x). ##### Q: How do I verify the upgrade succeeded? **A:** Run `sudo systemctl status artifactory.service` to confirm the service is running, access `http://:8082/ui/` in your browser to verify the UI loads, and monitor `tail -f $JFROG_HOME/artifactory/var/log/console.log` for startup errors. ##### Q: What should I do if Artifactory was previously installed as a service in a Linux Archive upgrade? **A:** If Artifactory was previously installed as a service, re-install it as a service after replacing the `app` folder by running `./installService.sh` from `$JFROG_HOME/artifactory/app/bin`. Without this step, a server restart may start the older version of Artifactory.