# Installing connectors in self-managed desktop modeler

**URL:** <https://forum.camunda.io/t/installing-connectors-in-self-managed-desktop-modeler/51353>\
**Category:** Discussion & Questions\
**Created:** [March 22, 2024, 11:16am UTC](https://forum.camunda.io/t/installing-connectors-in-self-managed-desktop-modeler/51353 "2024-03-22T11:16:20Z")\
**Posts on this page:** 3\
**Page:** 1

<div class="post-metadata">

**Author:** ![Thomas2](https://forum.camunda.io/letter_avatar_proxy/v4/letter/t/aeb1de/32.png) [@Thomas2](https://forum.camunda.io/u/Thomas2)\
**Post date:** [March 22, 2024, 11:16am UTC](https://forum.camunda.io/t/installing-connectors-in-self-managed-desktop-modeler/51353/1 "2024-03-22T11:16:20Z")

</div>

Hi,  
I’m completely new to all of this.  
I’m trying to run a self-managed version using the docker compose.  
To get the out-of-the-box connectors to work I simply had to add the element-templates to the folder of the camunda desktop modeler. But if I want to add any other connector I can’t get it to work. e.g. this one: [camunda-connectors/connector-smtp at main · Infosys/camunda-connectors · GitHub](https://github.com/Infosys/camunda-connectors/tree/main/connector-smtp)  
I build it using: mvn clean package, I then put the .jar in the docker container. (I add a volume in the docker\_compose.yml), but then when I start the container I get this error in the connectors container:

Error: Could not find or load main class io.camunda.connector.runtime.app.ConnectorRuntimeApplication  
Caused by: java.lang.ClassNotFoundException: io.camunda.connector.runtime.app.ConnectorRuntimeApplication

Any ideas what im doing wrong?

---

<div class="post-metadata">

**Author:** ![AndriyK](https://forum.camunda.io/letter_avatar_proxy/v4/letter/a/e19b73/32.png) [@AndriyK](https://forum.camunda.io/u/AndriyK)\
**Post date:** [April 28, 2025, 10:00pm UTC](https://forum.camunda.io/t/installing-connectors-in-self-managed-desktop-modeler/51353/2 "2025-04-28T22:00:33Z")

</div>

Thomas, i came across similar situation, wondering if you resolved it?

---

<div class="post-metadata">

**Author:** ![aravindhrs](https://forum.camunda.io/user_avatar/forum.camunda.io/aravindhrs/32/32503_2.png) [@aravindhrs](https://forum.camunda.io/u/aravindhrs)\
**Post date:** [April 29, 2025, 6:29am UTC](https://forum.camunda.io/t/installing-connectors-in-self-managed-desktop-modeler/51353/3 "2025-04-29T06:29:03Z")

</div>

Hi @Thomas2 , The `Error: Could not find or load main class io.camunda.connector.runtime.app.ConnectorRuntimeApplication`

means that the connector JAR you’re trying to run is not a full executable application — it’s just a connector implementation, not a “standalone Spring Boot application” like the standard connectors-bundle image expects.

In Camunda 8 Self-Managed, the Connectors Runtime container is a Spring Boot app that scans for connector “function” beans inside its classpath.

_When you mount your custom connector JAR, it should not try to replace the Connectors Runtime app, but simply be loaded into the Connectors Runtime classpath._

Your mistake seems to be trying to boot your custom connector JAR as a separate application, but the JAR you built (from Infosys’ repo) doesn’t include the main application class `(io.camunda.connector.runtime.app.ConnectorRuntimeApplication)` — that’s why you get that error.

To fix this properly:

1. Keep using the official Camunda Connectors Runtime container (e.g., camunda/connectors-bundle:latest).

2. Mount your custom connector JAR into the container, into a folder that’s on the classpath, e.g., /opt/connectors.

3. Tell the Connectors Runtime to scan your custom JAR by setting an environment variable:  
CAMUNDA\_CONNECTOR\_CUSTOM\_CONNECTORS\_ENABLED=true

4. Optionally, override classpath or extend the connectors runtime by creating a custom docker image if needed.

Assume you built the SMTP connector as connector-smtp-1.0.0.jar.

docker-compose.override.yml or directly inside docker-compose.yml:

```yaml
  connectors:
    image: camunda/connectors-bundle:latest
    environment:
      - CAMUNDA_CONNECTOR_CUSTOM_CONNECTORS_ENABLED=true
    volumes:
      - ./connectors:/opt/connectors

```

Your folder structure:

`./connectors/connector-smtp-1.0.0.jar`

The official Connectors Runtime will auto-scan /opt/connectors for JARs containing Beans.

```
•	Do NOT try to “start” your JAR manually.
•	Just drop your JAR into a directory mounted inside the container (like /opt/connectors).
•	Set CAMUNDA_CONNECTOR_CUSTOM_CONNECTORS_ENABLED=true.
•	Camunda Connectors Runtime auto-scans and finds the SMTP connector.
•	Then, you can use it by uploading or referencing its Element Template in the Modeler.

```

_If your SMTP connector is not a Spring Bean yet (it should implement the InboundConnectorFunction or OutboundConnectorFunction), make sure the @OutboundConnector or @InboundConnector annotations are properly present._
