Skip to main content

Get/Install Orkes Conductor

Use Conductor Playground

Playground is the easiest way to get started on Orkes Conductor.

Using Playground requires authorization keys which you can generate quickly by following the steps below:

  1. Login to https://play.orkes.io/ - you can bookmark this URL for easy access.
  2. Navigate to Applications from the left menu.
  3. Click Create Application button to create a new application and provide a name.
  4. Open the newly created application and enable Worker, Metadata API, and Application API permissions.
  5. Click Create Access Key to create the KEY and SECRET. A dialog box opens with the newly generated Key and Secret.

Important: Copy and store the Key and Secret in a safe location, as it is never displayed again.

Setup environment variables

export KEY=<Your KEY>
export SECRET=<Your SECRET>
export CONDUCTOR_SERVER_URL=https://play.orkes.io/api

You can generate another pair for your testing if you lose access to your key/secret pair.

Install and Run Locally

Pre-requisites: Docker should be installed.

Run the following command on the Unix, Linux or Mac OSX to download the container and start.

curl https://raw.githubusercontent.com/orkes-io/orkes-conductor-community/main/scripts/run_local.sh | sh

Alternatively, you can also run the container command explicitly:

docker run --init -p 8080:8080 -p 1234:5000 --mount source=redis,target=/redis \
--mount source=postgres,target=/pgdata orkesio/orkes-conductor-community-standalone:latest

Note the target folders for Redis and Postgres data. You can empty these if you want to reset your local installation.


Setup environment variables

export CONDUCTOR_SERVER_URL=http://localhost:8080/api

Install & Run Orkes Enterprise Edition Locally

Orkes publishes containers to DockerHub under orkesio organization.

Orkes Cloud Build for Local Development and Testing

Available to the users of Orkes Cloud, with all the Orkes cloud features on your local machine. Requires subscription to Orkes Cloud.

Orkes publishes orkes-conductor-standalone docker container that can be used for local development and testing.

The container is self-contained with the full Orkes development stack that contains a persistent store, Orkes server, and system workers.

note

The standalone container is only meant for local development and is not suitable for running any production workload.

orkes-conductor-standalone is available to the Orkes Customers and needs an authorization token to download the container.

Obtaining Authorization Token​

Please reach out to your Orkes contact to obtain the token.

Download and Run the Container​

Log in to the Docker Hub using Orkes Access Account. When prompted for the password, use the access token provided by the Orkes team.

note
  • If you do not have an access token (or have lost it), please contact support@orkes.io to issue a new one.
  • Standard security measures should be used within the organization when storing and distributing the access token.

Download and Run the Latest Container Build​

export orkes_access_key=<ACCESS_KEY_PROVIDED_BY_ORKES>
echo $orkes_access_key | docker login --username orkesdocker --password-stdin

# Create volumes for persistent stores
docker volume create postgres
docker volume create redis

# Download and start the container
docker run -i -p 8080:8080 -p 3000:5000 --mount source=redis,target=/redis \
--mount source=postgres,target=/pgdata orkesio/orkes-conductor-standalone:latest

Access Conductor UI

Navigate to http://localhost:3000.

Access Swagger API Documentation

http://localhost:8080/swagger-ui/index.html?configUrl=/api-docs/swagger-config#/.

Video Guides