Import Repositories

JFrog Artifactory Documentation

JFrog Artifactory
Content Type
User Guide

You can import repositories previously exported as described in Export Repositories. This is typically done when moving store and metadata between repositories and as part of batch operations.


  • Imported repositories have a required layout. For information on the required layout see Import Repository Layout

  • To disable the system import option, set the artifactory.system.import.enabled property in the fileArtifactory Configuration Files to false

  • To access import and export of your entire system, in the Administration module, select Import & Export | System

To import a previously exported repository:

  1. In the navigation panel on the left-hand side of the screen, click Administration administration-button.jpg.

  2. In the General pane, click Settings. The Artifactory General Settings screen appears.

  3. In the Import & Export pane, click Repositories.

    The Repositories Import screen appears. All users can import repositories from by zipping a repository and uploading it to Artifactory. Additionally, Self-Hosted users have the option of importing from a server-side folder.

  4. Complete the details as listed below, then click Import. The repository content is imported.



Target Local Repository

You can specify a single repository to import, or All Repositories. The repository layout should be different depending on your selection. Please refer to Import Layout.

Server Path for Import

The import source directory on your server. Note: This option is only available for Self-Hosted users.

Repository Zip File

Applicable when importing repo from zip file. Drop the repository zip file

Exclude Metadata

When set, repository metadata are excluded from the import

Output Verbose Log

When set, lowers the log level to "debug" and redirects the output from the standard log to the import-export log.

Monitoring the log

You can monitor the log in the System Logs page.

Don't exclude metadata for Docker

To work with a Docker repository, it must have its metadata intact. Therefore, when importing to/exporting from a Docker repository make sure that Exclude Metadata is not checked.

Importing into a Remote Repository Cache

You can take advantage of remote repositories you have already downloaded to your local environment, and import them directly into a local repository.

For example, you can take your local Maven repository (usually located under ~/.m2) and upload it into Artifactory so that all the artifacts you have already downloaded are now available on the server.