Hydra smoothly integrates with several development tools. Follow the appropriate link to get started with Hydra.

sbt

Installation

Navigate to the project on which you want to use Hydra and add the following inside the file project/plugins.sbt (if the file isn't there, create it).

For sbt 1.3+

resolvers += Resolver.url("Triplequote Plugins Releases",
  url("https://repo.triplequote.com/artifactory/sbt-plugins-release/"))(Resolver.ivyStylePatterns)
addSbtPlugin("com.triplequote" % "sbt-hydra" % "2.3.4")

Important for sbt 1.4

If already using sbt 1.4, it's recommended to upgrade to sbt 1.4.6+, as it provides an important thread-safety fix that can impact compilation with Hydra (sbt#6198).

Warning

Upgrading to sbt 1.4 is not recommended until sbt#6197 and sbt#6183 are fixed.

For sbt 0.13.13 to 1.3.13

Starting with Hydra 2.3.0 a new sbt-hydra-legacy plugin has been introduced to support Hydra compilation with older versions of sbt (from 0.13.13 up to 1.3.13).

resolvers += Resolver.url("Triplequote Plugins Releases",
  url("https://repo.triplequote.com/artifactory/sbt-plugins-release/"))(Resolver.ivyStylePatterns)
addSbtPlugin("com.triplequote" % "sbt-hydra-legacy" % "2.3.4")

Other than the supported sbt version, there are really no differences between the sbt-hydra and sbt-hydra-legacy plugins. In fact, all features and API offered by sbt-hydra are exactly the same in sbt-hydra-legacy.

Upgrade strategy

As sbt-hydra and sbt-hydra-legacy both work with sbt 1.3, the recommended strategy to avoid a big bang upgrade is to first upgrade your project to sbt 1.3.13 (while using sbt-hydra-legacy), and then switch to use sbt-hydra as the latter is compatible with sbt 1.3+. At this point, you may move forward with upgrading the sbt version to 1.4 and later.

sbt fails to resolve the Hydra artifacts

Warning

If sbt fails to resolve the Hydra artifacts please read this section for how to troubleshoot the problem.

Claim your trial license key

After adding the sbt-hydra plugin to your project simply type sbt hydraStartTrial to have a Hydra trial license key delivered to your mailbox.

License activation

Type the following, using the actual license key you received:

sbt "hydraActivateLicense XXXXX-XXXXX-XXXXX-XXXXX-XXXXX-XXXXX-XXXXX-XXXXX-XXXXX-XXXXX-XXXXX"
[info] Activating using https://activation.triplequote.com/algas/. This may take some time..
[info] License successfully activated

Warning

Surround the activation command with quotes (") or activation will fail because the input will not be properly parsed.

Congratulations, you have successfully installed Hydra!

To learn how Hydra works and get the most out of it, continue reading the getting started.