Subscriptions and Bintray credentials

Lightbend Platform includes both open source components that are distributed from the Maven Central Repository, and commercial components that are distributed from a private artifact repository hosted on Bintray. A Lightbend Subscription entitles you to use all features of the Lightbend Platform and includes support and Lightbend Academy.

Once you have a subscription, follow the steps below to obtain Bintray credentials and make them available on workstations and build servers where you will be building or installing Lightbend Platform components. Contact us for help with a subscription or with logging in.

If you are developing applications, this page shows how to supply Bintray credentials for sbt, Maven, or Gradle. Library build dependencies lists the dependencies to add for the latest versions of Lightbend Platform libraries.

Obtaining and supplying credentials

  1. Log in to the Customer Portal.

    The Credentials page displays:

    Lightbend Credentials page
  2. Copy the user ID and password token and save them in a file named commercial.credentials that contains the following lines:

    realm = Bintray
    host = dl.bintray.com
    user = <userid>
    password = <token>
  3. Save the commercial.credentials file in one of the following locations:

    • for Linux or Mac: ~/.lightbend/commercial.credentials

    • for Windows: %HOMEPATH%\.lightbend\commercial.credentials

After making the credentials available on the workstation where you will be running Lightbend Platform components, configure sbt, Maven, or Gradle to point to them.

Updating credentials

You might need to update your existing credentials if you didn’t obtain them recently. For example, you will need to update them if you get the following error from OpenShift when trying to install Lightbend Console:

$ oc describe pod -n lightbend es-console
<snip> Repo 'commercial-registry' was not found

Reset your credentials to update them:

  1. Log in to the Customer Portal.

    The credentials page should display.

  2. To the right of your password, click Show.

  3. Click Reset to get new credentials.

  4. Copy the new values to update the user and password entries in $HOME/.lightbend/commercial.credentials.

sbt

After you have saved your commercial.credentials file, follow these steps to configure sbt with Lightbend Platform credentials:

  1. Make sure that your project is using an sbt version of 0.13.7 or higher (we recommend 1.2.8). Declare the sbt.version variable in project/build.properties, for example:

    sbt.version=1.2.8

  2. Add the following to your project/lightbend.sbt sbt plugins to point to your commercial.credentials file:

    credentials += Credentials(Path.userHome / ".lightbend" / "commercial.credentials")
    resolvers += "com-mvn" at "https://repo.lightbend.com/commercial-releases/"
    resolvers += Resolver.url("com-ivy",
      url("https://repo.lightbend.com/commercial-releases/"))(Resolver.ivyStylePatterns)
  3. Add the following settings to any of the sbt projects in your build to add Lightbend Platform components:

    credentials += Credentials(Path.userHome / ".lightbend" / "commercial.credentials")
    resolvers += "com-mvn" at "https://repo.lightbend.com/commercial-releases/"
    resolvers += Resolver.url("com-ivy",
      url("https://repo.lightbend.com/commercial-releases/"))(Resolver.ivyStylePatterns)

Maven

After you have saved your commercial.credentials file, follow these steps to provide Lightbend Platform credentials to Maven:

  1. Add your Lightbend Platform credentials to the file ~/.m2/settings.xml, substituting them in the username and password elements:

    <settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
              xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
              xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0
                              https://maven.apache.org/xsd/settings-1.0.0.xsd">
        <servers>
            <server>
                <id>lightbend-commercial</id>
                <username>your username</username>
                <password>your password</password>
            </server>
        </servers>
    </settings>
  2. Add the Lightbend Platform repository to your build:

    <repository>
      <id>lightbend-commercial</id>
      <name>Lightbend Commercial</name>
      <url>https://lightbend.bintray.com/commercial-releases</url>
    </repository>

Gradle

After you have saved your commercial.credentials file, add the following Maven repository to build.gradle, substituting the value of your credentials:

repositories {
    maven {
        credentials {
            username 'your username'
            password 'your password'
        }
        mavenCentral()
        url = 'https://lightbend.bintray.com/commercial-releases'
    }
}