Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.


Artifactory hosts three types of repository:

Local and remote repositories are true physical repositories, while a virtual repository is actually an aggregation of them used to create controlled domains for search and resolution of artifacts.

To configure repositories, in the Admin module, select Repositories.

Repositories can be created, deleted, edited, ordered and aggregated.

Single Package Type

When creating any repository, you must specify its package type; this is a fundamental characteristic of the repository and can not be changed later. Once the repository type is set, Artifactory will index artifacts and calculate the corresponding metadata for every package uploaded which optimizes performance when resolving artifacts. Note that virtual repositories can only include repositories of the same type.

titleWrong Package Type

While Artifactory will not prevent you from uploading a package of the wrong type to a repository, we strongly recommend maintaining consistency between the repository type and packages you upload.

if you do upload packages of the wrong type to a repository, Artifactory will not index the package or update the metadata for the repository.

Selecting the repository package type

titlePage Contents

Table of Contents

titleRead More

Children Display

Generic Repositories

You may define a repository as Generic in which case it has no particular type, and you may upload packages of any type. Generic repositories do not maintain separate package indexes. For using a client associated with a specific package type (e.g. yum, gem) you should create a matching repository.


Local Repositories

Local repositories are physical, locally-managed repositories into which you can deploy artifacts.


For full details on configuring local repositories, please refer to Local Repositories.


Remote Repositories

remote repository serves as a caching proxy for a repository managed at a remote URL (which may itself be another Artifactory remote repository).  


For full details on configuring remote repositories please refer to Remote Repositories.


Virtual Repositories

A virtual repository (or "repository group") aggregates several repositories with the same package type under a common URL. The repository is virtual in that you can resolve and retrieve artifacts from it but you cannot deploy artifacts to it.

titleGeneric Virtual Repositories

By their nature, Virtual Repositories whose package type has been specified as Generic can aggregate repositories of any type, however generic virtual repositories do not maintain any metadata

The Default Virtual Repository (Deprecated)

Artifactory offers an option to use a global virtual, which contains all local and remote repositories.



Virtual Resolution Order

When an artifact is requested from a virtual repository, the order in which repositories are searched or resolved is local repositories first, then remote repository caches, and finally remote repositories themselves.


For a virtual repository, you can see the effective search and resolution order in the Included Repositories list view in the Basic settings tab. This is particularly helpful when nesting virtual repositories. For more details on configuring a virtual repository please refer to Virtual Repositories.


General Resolution Order

You can set the order in which repositories of each type (local, remote and virtual) are searched and resolved by simply ordering them accordingly within the corresponding section of the Configure Repositories page. To set the order you need to add the repositories to the list of selected repositories in the order in which they should be searched to resolve artifacts.