Overview
In certain versions of Artifactory (7.146.X), downloading artifacts directly from the Artifactory User Interface (UI) may fail. Instead of downloading the requested binary artifact, the download endpoint returns an HTML page.
Symptoms
When a user is attempting to download artifacts through the web UI may observe the following:
- Clicking Download from the UI does not download the artifact.
- The browser opens or downloads an HTML document instead of the expected binary file.
- Download URLs generated from the UI use endpoints similar to:
- /ui/native/...
- /ui/repos/tree/...
- The artifact exists in the repository and can still be downloaded successfully using the direct repository URL or REST API.
Affected Versions
Root Cause
This issue is caused by an internal bug in the UI request routing mechanism.
When a download request is initiated from the Artifactory UI, native browser requests are incorrectly redirected through the UI layout context. As a result, instead of streaming the requested artifact, the application returns the HTML page associated with the UI.
This behavior is tracked internally as: RTDEV-87580
Workaround
Until a permanent fix is available, the issue can be mitigated by disabling the configuration that redirects native browser requests through the UI.
Steps
- Navigate to your JFrog installation directory.
- Open the following configuration file:
$JFROG_HOME/artifactory/var/etc/artifactory/artifactory.system.properties
- Add the following property if it does not already exist, or update it if present:
artifactory.redirect.native.browser.requests.to.ui=false
- Save the file.
- Restart the Artifactory service for the change to take effect.
Expected Result
After applying the configuration change and restarting Artifactory:
- Downloads initiated from the Artifactory UI should correctly stream the requested binary artifact.
- HTML pages should no longer be returned in place of the artifact payload.
NOTE: The fix is planned in upcoming releases. Please monitor the artifactory release notes for details on the version in which it will be included.