> For the complete documentation index, see [llms.txt](https://docs.omics.ai/products/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.omics.ai/products/workbench/getting-started/connect-an-engine.md).

# Connecting an Engine

## Connecting an Engine to Workbench

Before you can run workflows, you need to connect Workbench to a workflow engine. This connection enables the complete workflow execution process.

When you launch a workflow, Workbench submits it to your connected engine. The workflow engine interprets your workflow specification and generates commands for individual tasks. These commands are then dispatched to your cloud or HPC backend, where the engine orchestrates computational resources, executes the work, and writes outputs to cloud storage.

### Supported Platforms

Workbench supports workflow execution across major cloud platforms and on-premises environments:

* Amazon Web Services ([AWS HealthOmics](https://aws.amazon.com/healthomics/resources/))
* Google Cloud Platform ([Life Sciences API](https://cloud.google.com/life-sciences/docs/reference/rest) or [DNAstack WES](https://github.com/DNAstack/cromwell-wes-service))
* Microsoft Azure ([Microsoft CoA](https://github.com/microsoft/CromwellOnAzure) or [DNAstack WES](https://github.com/DNAstack/cromwell-wes-service))
* On-Premises ([DNAstack WES](https://github.com/DNAstack/cromwell-wes-service))

{% hint style="info" %}
For detailed information about engines and cloud backends, refer to [Deploying an Engine](https://docs.omics.ai/products/introduction-to-engines-and-backends).
{% endhint %}

## Connecting Your Engine

To connect Workbench to a workflow engine, you'll need specific configuration details from your IT administrator. These details allow Workbench to properly communicate with your engine deployment.

Follow these steps to connect your engine:

1. Navigate to "Settings" in the sidebar to view your current engine configurations
2. Click "Add Engine" in the top right corner
3. Select your engine and cloud backend combination
4. Complete the configuration form with your provided details
5. Click "Save" to finalize the connection

After successful configuration, your new engine will appear in the Workflow Engines table on the Settings page.

{% hint style="info" %}
Engine configuration is typically a one-time setup process. Contact your IT administrator if you need help with configuration details.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.omics.ai/products/workbench/getting-started/connect-an-engine.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.