Still using Artifactory 3.x ?
Click here for the Artifactory 3.x User Guide

Have a question? Want to report an issue? Contact JFrog support

Skip to end of metadata
Go to start of metadata


To configure a local repository, in the Admin module, go to Repositories | Local and click it to display the Edit Repository screen.

Common Basic Settings

The following are fully described in the Common Settings page.

Page Contents

Additional Basic Settings

Repositories may have additional Basic settings depending on the Package Type.

Maven, Gradle, Ivy and SBT Repositories

Maven, Gradle, Ivy and SBT repositories share the same additional Basic settings.

Checksum Policy

Checking the Checksum effectively verifies the integrity of a deployed resource. The Checksum Policy determines how Artifactory behaves when a client checksum for a deployed resource is missing or conflicts with the locally calculated checksum.

There are two options:

  1. Verify against client checksums (default) - If a client has not sent a valid checksum for a deployed artifact then Artifactory will return a 404 (not found) error to a client trying to access that checksum. If the client has sent a checksum, but it conflicts with the one calculated on the server then Artifactory will return a 409 (conflict) error until a valid checksum is deployed.
  2. Trust server generated checksums - Artifactory will not verify checksums sent by clients and will trust the server's locally calculated checksums. An uploaded artifact is immediately available for use, but integrity might be compromised.

Maven Snapshot Version Behavior

Artifactory supports centralized control of how snapshots are deployed into a repository, regardless of end user-specific settings. This can be used to guarantee a standardized format for deployed snapshots within your organization. There are three options:
  1. Unique: Uses a unique, time-based version number
  2. Nonunique: Uses the default self-overriding naming pattern: artifactID-version-SNAPSHOT.type
  3. Deployer: Uses the format sent by the deployer as is.

Maven 3 Only Supports Unique Snapshots

Maven 3 has dropped support for resolving and deploying non-unique snapshots. Therefore, if you have a snapshot repository using non-unique snapshots, we recommend that youchange your Maven snapshot policy to 'Unique' and remove any previously deployed snapshots from this repository.

The unique snapshot name generated by the Maven client on deployment cannot help in identifying the source control changes from which the snapshot was built and has no relation to the time sources were checked out. Therefore,we recommend that the artifact itself should embed the revision/tag (as part of its name or internally) for clear and visible revision tracking. Artifactory allows you to tag artifacts with the revision number as part of its Build Integration support.

Max Unique Snapshots

Specifies the maximum number of unique snapshots of the same artifact that should be stored. Once this number is reached and a new snapshot is uploaded, the oldest stored snapshot is removed automatically.

A value of 0 (default) indicates that there is no limit on the number of unique snapshots.

Handle Releases 

If set, Artifactory allows you to deploy release artifacts into this repository.


Handle Snapshots

If set, Artifactory allows you to deploy snapshot artifacts into this repository.

Suppress POM Consistency

When deploying an artifact to a repository, Artifactory verifies that the value set for groupId:artifactId:version in the POM is consistent with the deployed path.

If there is a conflict between these then Artifcatory will reject the deployment. You can disable this behavior by setting this checkbox.

Other Repository Types

For other type-specific repository configuration, please refer to the corresponding repository page under Artifactory Pro.

Advanced Settings

Local Repository Advanced Settings

Select Property Sets

Defines the property sets that will be available for artifacts stored in this repository.

Blacked Out

If set, Artifactory ignores this repository when trying to resolve artifacts. The repository is also not available for download or deployment of artifacts.

Allow Content Browsing

If set, allows you to view file contents (e.g., Javadoc browsing, HTML files) directly from Artifactory.


When content browsing is allowed we recommend strict content moderation to ensure that any uploaded content does not compromise security (for example, cross-site scripting attacks) 

Pre-defined Local Repositories

Artifactory comes with a set of pre-defined local repositories, which reflect best practices in binary repository management as follows: 


Your code releases


Your code snapshots


Manually deployed 3rd party libs (releases)


Manually deployed 3rd party libs (shapshots)


Your and 3rd party plugins (releases)


Your and 3rd party plugins (snapshots)

  • No labels