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

description

description
Building from Source — build and run the Conductor server and ui-next locally for development and testing.

Building from source

Build and run the Conductor server and ui-next 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/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 ui-next from source

Prerequisites

• A running Conductor server on port 8080
• Node.js 18+
• pnpm 10.x (activate the version pinned by ui-next/package.json with corepack enable)

Steps

cd ui-next
corepack enable
pnpm install

Configure the backend URL in .env (the checked-in default targets a local server):

VITE_WF_SERVER=http://localhost:8080

Start the development server:

pnpm dev

The UI is accessible at http://localhost:1234. For runtime feature flags and authentication configuration, copy public/context.js.example to public/context.js and edit the copy.

To build compiled assets for production hosting:

pnpm build

The production build is written to ui-next/dist/.