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:

   shellCopy

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

2. Run with Gradle:

   shellCopy

   cd server
   ../gradlew bootRun
   

   To use a custom configuration file:

   shellCopy

   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