Skip to main content

Installation

This page shows you how to:

  1. Install the lhctl command-line utility for the LittleHorse Server.
  2. Set up a LittleHorse Server for local development in Docker.
  3. Add the dependency for the LittleHorse SDK in the language of your choice.
tip

For fast responses, we recommend you join our LittleHorse Community Slack Workspace to exchange ideas about and receive support for LittleHorse.

Your system will need:

  • brew or go to install lhctl (if you use go, make sure to put ~/go/bin in your PATH).
  • docker to run the LittleHorse Server.
  • Either go, java, or python to run the client libraries.

LittleHorse CLI​

You can install the lhctl utility either using homebrew or by downloading it from our github release page.

Installation via Homebrew has been tested on Mac and Linux.

brew install littlehorse-enterprises/lh/lhctl

LittleHorse Server (Local Dev)​

The easiest way to run the LittleHorse Server is using the lh-standalone docker image. You can do so as follows:

docker run --pull always --name littlehorse -d -p 2023:2023 -p 8080:8080 ghcr.io/littlehorse-enterprises/littlehorse/lh-standalone:latest

Note that the lh-standalone image is only suitable for local development. Once the container is up and running, you should be able to verify that the server is working as follows:

-> lhctl version
lhctl version: 0.12.4 (Git SHA homebrew)
Server version: 0.12.4
info

The lh-standalone image takes some time to start up since it first starts a Kafka Broker process before starting the LittleHorse Server process. If your lhctl search wfSpec command fails at first, keep trying for about 20-40 seconds until Kafka is ready.

You should be able to access the LittleHorse Developer Dashboard at http://localhost:8080/ after the lh-standalone image has started up.

LittleHorse Client Libraries​

All the LittleHorse Client libraries, including grpc clients, can be accessed through standard installation mechanisms in a language of your choice.

The Java Client Library is available on Maven Central. To add it as a dependency to your project, simply put the following in your build.gradle (or do the equivalent with your pom.xml)

implementation 'io.littlehorse:littlehorse-client:0.12.4'

Get Started​

You can use one of the LittleHorse Quickstarts to get going really fast:

Additional rich examples can be found at our core GitHub repository.