Skip to content

source.md

Latest commit

 

History

History
83 lines (55 loc) · 1.95 KB

source.md

File metadata and controls

83 lines (55 loc) · 1.95 KB
description
Building from Source — build and run the Conductor server and UI locally from source for development and testing.

Building from source

Build and run Conductor server and UI locally from source. The default configuration uses in-memory persistence with no indexing — all data is lost when the server stops. This setup is for development and testing only.

For persistent backends, use Docker Compose or configure a database backend.

Prerequisites

  • Java (JDK) 17+
  • (Optional) Docker for running tests

Building and running the server

  1. Clone the repository:

    git clone https://github.com/conductor-oss/conductor.git
cd conductor

  2. Run with Gradle:

    cd server
../gradlew bootRun

    To use a custom configuration file:

    CONFIG_PROP=config.properties ../gradlew bootRun

  3. The server is now running:

    URL Description
    http://localhost:8080 Conductor UI
    http://localhost:8080/swagger-ui/index.html REST API docs
    http://localhost:8080/api/ API base URL

Running from a pre-compiled JAR

As an alternative to building from source, download and run the pre-compiled JAR:

export CONDUCTOR_VER=3.21.10
export REPO_URL=https://repo1.maven.org/maven2/org/conductoross/conductor-server
curl $REPO_URL/$CONDUCTOR_VER/conductor-core-$CONDUCTOR_VER-boot.jar \
  --output conductor-core-$CONDUCTOR_VER-boot.jar
java -jar conductor-core-$CONDUCTOR_VER-boot.jar

Running the UI from source

Prerequisites

  • A running Conductor server on port 8080
  • Node.js v18+
  • Yarn

Steps

cd ui
yarn install
yarn run start

The UI is accessible at http://localhost:5000.

To build compiled assets for production hosting:

yarn build