---
updatedAt: 2026-06-07T14:05:02.000Z
agentTools:
  siteIndex: https://docs.jfrog.com/llms.txt
  projectIndex: https://docs.jfrog.com/installation/llms.txt
---

# Artifactory Windows Archive Upgrade

Upgrade Artifactory on Windows by downloading and replacing the .zip archive.

Upgrading Artifactory on Windows is a straightforward process that involves downloading the new .zip archive, stopping the current service, and manually replacing the application files. This method offers a flexible solution for managing Artifactory directly on a Windows system.

Choose your environment below to get started:

* [Upgrade Artifactory with a Windows Archive](#upgrade-artifactory-on-windows)

## Upgrade Artifactory on Windows

This topic provides the steps to upgrade your JFrog Artifactory 7.x instance installed via a Windows 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 Windows Archive.

1. **Stop Artifactory:** Navigate to the `bin` directory and stop the service.

   ```bash
   cd %JFROG_HOME%\artifactory\app\bin
   artifactory.bat stop
   ```
2. **Download and Extract the New Archive:** Download the new `.zip` archive for your target version and extract its contents to a temporary location.

   ```bash
   # Example paths
   SET JFROG_HOME=C:\Program Files\jfrog
   SET JF_NEW_VERSION=C:\Temp\artifactory-pro-7.x

   # Download and extract the .zip file to the new version directory.
   # You will need to use a tool like 7-Zip or PowerShell's Expand-Archive.
   ```
3. **Replace the existing `app` folder:** Use the following commands to replace the existing `app` folder with the new one.

   ```bash
   # Remove old app directory
   rmdir %JFROG_HOME%\artifactory\app /s /q

   # Copy new app directory
   xcopy %JF_NEW_VERSION%\app %JFROG_HOME%\artifactory\app /e /i

   # Remove the temporary extracted new version
   rmdir %JF_NEW_VERSION% /s /q
   ```
4. **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.

   ```text
   Search Impacted Resources by Package Version
   ```
5. **Add your Database Connector (if required):** If your database requires a specific driver, add it to `%JFROG_HOME%\artifactory\var\bootstrap\artifactory\tomcat\lib` before starting Artifactory services. For example, add the MySQL connector if you use a MySQL database.
6. **Start Artifactory:** Start the Artifactory service.

   ```bash
   sc start artifactory
   ```

   Alternatively, you can manage Artifactory manually using the control script:

   ```bash
   %JFROG_HOME%\artifactory\app\bin\artifactory.bat start|stop|check
   ```
7. **Verify the Upgrade:**

   * **Access UI:** Open your browser and navigate to `http://<SERVER_HOSTNAME>:8082/ui/` to verify the UI loads.
   * **Description**: Search all resources (artifacts) that include a specific package version.

#### 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 Linux Package Upgrade](upgrade-linux-package)
* [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)