conductor-oss--conductor/docs/devguide/running/source.md

description

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) 21+
• (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