SBT Repositories

A local SBT repository is used as a target to which you can deploy the output of your build.sbt script. To create an SBT repository, from the Administration module, under Repositories | Repositories | Local, set the Package Type to SBT.

A remote repository defined in Artifactory serves as a caching proxy for a registry managed at a remote URL.

Artifacts (such as JAR files) requested from a remote repository are cached on demand. You can remove downloaded artifacts from the remote repository cache, however, you can not manually deploy artifacts to a remote SBT repository.

To define a remote SBT repository to proxy a remote SBT registry follow the steps below:

The parameters needed to configure remote SBT repositories are identical to those used for Maven repositories. For more details, please refer to Remote Repositories.

A Virtual Repository defined in Artifactory aggregates packages from both local and remote repositories.

This allows you to access both locally hosted JARS and remote proxied SBT registries from a single URL defined for the virtual repository.

To define a virtual SBT repository, from the Administration module, go to Repositories | Repositories | Virtual, set the Package Type to SBT, and select the underlying local and remote SBT repositories to include in the Basic settings tab.

Click Save & Finish to create the repository.

The parameters needed to configure virtual SBT repositories are identical to those used for Maven repositories. For more details, please refer to Virtual Repositories.

To configure a repository defined in Artifactory as a proxy repository for SBT, add the code snippet below to your ~/.sbt/repositories file (C:\Users\%USERNAME%\.sbt\repositories on Windows).

[repositories]
local
my-ivy-proxy-releases: http://<host>:<port>/artifactory/<repo-key>/, [organization]/[module]/(scala_[scalaVersion]/)(sbt_[sbtVersion]/)[revision]/[type]s/[artifact](-[classifier]).[ext]
my-maven-proxy-releases: http://<host>:<port>/artifactory/<repo-key>/

Where <host>:<port> are the host URL and port on which Artifactory is running.

For example, if you are running Artifactory on your local machine, on port 8081, and want to proxy Ivy repositories through a repository called sbt-ivy-proxy, and proxy Maven repositories through a repository called sbt-maven-proxy you would use:

[repositories]
local
my-ivy-proxy-releases: http://localhost:8081/artifactory/sbt-ivy-proxy/, [organization]/[module]/(scala_[scalaVersion]/)(sbt_[sbtVersion]/)[revision]/[type]s/[artifact](-[classifier]).[ext]
my-maven-proxy-releases: http://localhost:8081/artifactory/sbt-maven-proxy/

To specify that all resolvers added in the SBT project should be ignored in favor of those configured in the repositories configuration, add the following configuration option to the SBT launcher script:

-Dsbt.override.build.repos=true

You can also add this setting to your /usr/local/etc/sbtopts ( C:\Program Files (x86)\sbt\conf\sbtopts on Windows)

For more details on SBT proxy repositories, please refer to Proxy Repositories in the SBT Reference Manual.

To resolve artifacts through Artifactory, simply add the following code snippet to your build.sbt file:

resolvers += "Artifactory" at "http://<host>:<port>/artifactory/<repo-key>/"

Where <host>:<port> are the host URL and port on which Artifactory is running, and repo-key is the Artifactory repository through which you are resolving artifacts

To deploy SBT build artifacts to repositories in Artifactory, add the following code snippets to your build.sbt file.

For releases, add:

publishTo := Some("Artifactory Realm" at "http://<host>:<port>/artifactory/<repo-key>")
credentials += Credentials("Artifactory Realm", "<host>", "<USERNAME>", "<PASS>")

For snapshots, add:

publishTo := Some("Artifactory Realm" at "http://<host>:<port>/artifactory/<repo-key>;build.timestamp=" + new java.util.Date().getTime)
credentials += Credentials("Artifactory Realm", "<host>", "<USERNAME>", "<PASS>")

Where <host>:<port> is the host URL and port on which Artifactory is running, and repo-key is the Artifactory repository to which you are deploying artifacts.