Skip to main content

Setting Up Orkes Conductor

Orkes Conductor can be set up in the cloud or locally, depending on your use case and requirements.

Orkes Cloud

Orkes Cloud is the fully managed enterprise version of Orkes Conductor. With Orkes Cloud, you can deploy dedicated Conductor clusters on preferred cloud providers.

There are two hosting options:

  • Orkes-hosted - End-to-end hosting managed by Orkes.
  • Customer-hosted - Deploy within your own infrastructure (Azure, AWS, GCP, or private cloud).

You can try Orkes Playground for immediate testing. A 14-day free trial of Orkes Cloud is also available for setting up custom Conductor clusters.

Orkes Conductor - Local Setup

Orkes Cloud users can utilize the Orkes Cloud containers available on DockerHub under the orkesio organization for local development and testing of the Orkes Conductor clusters. These containers include all the Cloud features but require an Orkes Cloud subscription.

The orkes-conductor-standalone container is ideal for local development and testing. It includes the full Orkes stack, with a persistent store, server, and system workers. To download it, you'll need an authorization token from the Orkes team.

note

These containers are not meant for production environments.

Pre-requisites:

  • Docker must be installed.
  • Subscription to Orkes Cloud.
  • Authorization token from Orkes team. (Contact support@orkes.io for an authorization token.)​

To download and run the container:

  1. Log in to DockerHub using your Orkes access account. When prompted for a password, use the access token provided by Orkes.
  2. 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

The UI can be accessed at http://localhost:3000 and API docs at http://localhost:8080/swagger-ui/.