Download a Folder

JFrog Artifactory Documentation
Products
JFrog Artifactory
Content Type
User Guide

You can download a complete folder and its contents from the browser on the Artifacts page. This feature is configurable by a JFrog Artifactory administrator.

To download a folder:

  1. Do one of the following:

    • On the Artifacts page, right-click the folder in the browser and select Download.

      Manipulating Artifacts Download from Action Menu.png

    • Select the folder from the browser and in the details pane, click Download.

      download_button_folder.png

    The Download Folder window appears.

    Manipulating Artifacts Download.png

  2. Select an archive type from the list. Supported formats are zip, tar, tar.gz and tgz.

  3. Optionally, select the Include Checksum Files checkbox.

    In Artifactory, checksum files (.sha1, .sha256 and .md5 files) are displayed and are downloadable in the HTML browsing endpoint (for example, http://<ARTIFACTORY>/artifactory/<REPOSITORY_KEY>), depending on one of the below pre-conditions:

    • The artifact was originally uploaded with its checksum value. For example, if the deploying client provided the X-Checksum-Sha1 header on the request

    • The repository Checksum Policy is set to "Trust Server Generated Checksums"

    If the latter applies, there is no need to provide the artifact checksums during the upload in order for its checksum files to be visible.

    The Download Folder functionality mimics this mechanism, and will write checksum files to the output archive based on the same conditions.

    With remote repository caches, there is no distinction for the checksum policy of the repository. Selecting this checkbox will always result in checksum files being added.

  4. Click Download. The file and its contents are downloaded.

You can also download a folder using the REST API.Retrieve Folder or Repository Archive

Folder Download Configuration

An Artifactory administrator can enable complete folder download in the Administration tab under Artifactory > General > Settings. This configuration applies to all Artifactory users. The following table describes the configuration options for folder download.

Field

Description

Max Size

The maximum size (MB) of artifacts that can be downloaded in a folder download.

Max Number of Files

The maximum number of artifacts that may be downloaded from the selected folder and all its sub-folders.

Max Parallel Folder Downloads

The maximum number of concurrent folder downloads allowed.

Blocked Folder Download

When trying to download a folder, if any of the artifacts in that folder are blocked for download, then downloading the folder fails with an HTTP FORBIDDEN (403) error.