{"id":27737085,"url":"https://github.com/edwinvw/camunda-alpha","last_synced_at":"2025-04-28T14:36:18.155Z","repository":{"id":263959545,"uuid":"891905809","full_name":"EdwinVW/camunda-alpha","owner":"EdwinVW","description":"Temporary repo for testing Camunda Alpha APIs","archived":false,"fork":false,"pushed_at":"2024-11-21T07:27:06.000Z","size":31,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-11-21T08:25:54.056Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/EdwinVW.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":"code-of-conduct.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-11-21T07:00:00.000Z","updated_at":"2024-11-21T07:27:10.000Z","dependencies_parsed_at":"2024-11-21T08:36:06.347Z","dependency_job_id":null,"html_url":"https://github.com/EdwinVW/camunda-alpha","commit_stats":null,"previous_names":["edwinvw/camunda-alpha"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EdwinVW%2Fcamunda-alpha","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EdwinVW%2Fcamunda-alpha/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EdwinVW%2Fcamunda-alpha/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EdwinVW%2Fcamunda-alpha/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/EdwinVW","download_url":"https://codeload.github.com/EdwinVW/camunda-alpha/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251331219,"owners_count":21572439,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-04-28T14:36:17.503Z","updated_at":"2025-04-28T14:36:18.134Z","avatar_url":"https://github.com/EdwinVW.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Camunda Platform 8\n\nThis repository contains links to Camunda Platform 8 resources, the official release artifacts (binaries), and supporting config files for running Docker Compose as a local development option. \n\n:warning: **Docker Compose is only recommended for local development.** :warning:\n\n\nWe recommend using [SaaS](https://camunda.com/get-started/) or [Helm/Kubernetes](https://docs.camunda.io/docs/self-managed/setup/overview/) for development.\n\nFor more information about Self-Managed, including additional [development installation options](https://docs.camunda.io/docs/self-managed/setup/overview/), see our [documentation](https://docs.camunda.io/docs/self-managed/about-self-managed/).\n\n\nFor production setups we recommend using [Helm charts](https://docs.camunda.io/docs/self-managed/setup/install/) which can be found at [helm.camunda.io](https://helm.camunda.io/).\n\n## Links to additional Camunda Platform 8 repos and assets\n\n- [Documentation](https://docs.camunda.io)\n- [Camunda Platform SaaS](https://camunda.io)\n- [Getting Started Guide](https://github.com/camunda/camunda-platform-get-started)\n- [Releases](https://github.com/camunda/camunda-platform/releases)\n- [Helm Charts](https://helm.camunda.io/)\n- [Zeebe Workflow Engine](https://github.com/camunda/zeebe)\n- [Contact](https://docs.camunda.io/contact/)\n\n## Using Docker Compose\n\n\u003e :information_source: The docker-compose file in this repository uses the latest [compose specification](https://docs.docker.com/compose/compose-file/), which was introduced with docker compose version 1.27.0+. Please make sure to use an up-to-date docker compose version.\n\n\u003e :information_source: Docker 20.10.16+ is required.\n\n\u003e :information_source: To support token refresh and logout your local machine needs to resolve `keycloak` to `127.0.0.1` and the variable `KEYCLOAK_HOST` needs to be set to `keycloak` in the `.env` file.\n\nTo spin up a complete Camunda Platform 8 Self-Managed environment locally the [docker-compose.yaml](docker-compose.yaml) file in this repository can be used.\n\nThe full environment contains these components:\n- Zeebe\n- Operate\n- Tasklist\n- Connectors\n- Optimize\n- Identity\n- Elasticsearch/Opensearch\n- Keycloak\n- PostgreSQL\n\n\u003e :information_source: Web Modeler is not included by default. Please follow [the instructions below](#web-modeler-self-managed) to install it.\n\nClone this repo and issue the following command to start your environment:\n\n```\ndocker compose up -d\n```\n\nWait a few minutes for the environment to start up and settle down. Monitor the logs, especially the Keycloak container log, to ensure the components have started.\n\nNow you can navigate to the different web apps and log in with the user `demo` and password `demo`:\n- Operate: [http://localhost:8081](http://localhost:8081)\n- Tasklist: [http://localhost:8082](http://localhost:8082)\n- Optimize: [http://localhost:8083](http://localhost:8083)\n- Identity: [http://localhost:8084](http://localhost:8084)\n- Elasticsearch: [http://localhost:9200](http://localhost:9200)\n\nKeycloak is used to manage users. Here you can log in with the user `admin` and password `admin`\n- Keycloak: [http://localhost:18080/auth/](http://localhost:18080/auth/)\n\nThe workflow engine Zeebe is available using gRPC at `localhost:26500`.\n\nTo tear down the whole environment run the following command:\n\n```\ndocker compose down -v\n```\n\nZeebe, Operate, Tasklist, along with Optimize require a separate network from Identity as you'll see in the docker-compose file.\n\n### Using the basic components\n\nIf Optimize, Identity, and Keycloak are not needed you can use the [docker-compose-core.yaml](docker-compose-core.yaml) instead which does not include these components:\n\n```\ndocker compose -f docker-compose-core.yaml up -d\n```\n**OR**\n\nSet parameter ```SEARCH_DB=opensearch``` in the file ```.env``` if you want to use OpenSearch instead of ElasticSearch\n```\ndocker compose -f docker-compose-core.yaml --profile opensearch up -d\n```\n\n### Deploying BPMN diagrams\n\nIn addition to the local environment setup with docker compose, use the [Camunda Desktop Modeler](#desktop-modeler) to locally model BPMN diagrams for execution and directly deploy them to your local environment.\nAs an enterprise customer, you can [use Web Modeler](#web-modeler-self-managed).\n\nFeedback and updates are welcome!\n\n## Securing the Zeebe API\n\nBy default, the Zeebe GRPC API is publicly accessible without requiring any client credentials for development purposes.\n\nYou can however enable authentication of GRPC requests in Zeebe by setting the environment variable `ZEEBE_AUTHENTICATION_MODE` to `identity`, e.g. via running:\n```\nZEEBE_AUTHENTICATION_MODE=identity docker compose up -d\n```\nor by modifying the default value in the [`.env`](.env) file.\n\n## Connectors\n\nBoth docker-compose files contain our [out-of-the-box Connectors](https://docs.camunda.io/docs/components/integration-framework/connectors/out-of-the-box-connectors/available-connectors-overview/).\n\nRefer to the [Connector installation guide](https://docs.camunda.io/docs/self-managed/connectors-deployment/install-and-start/) for details on how to provide the related Connector templates for modeling.\n\nTo inject secrets into the Connector runtime they can be added to the\n[`connector-secrets.txt`](connector-secrets.txt) file inside the repository in the format `NAME=VALUE`\nper line. The secrets will then be available in the Connector runtime with the\nformat `secrets.NAME`.\n\nTo add custom Connectors either create a new docker image bundling them as\ndescribed [here](https://github.com/camunda/connectors-bundle/tree/main/runtime).\n\nAlternatively, you can mount new Connector JARs as volumes into the `/opt/app` folder by adding this to the docker-compose file. Keep in mind that the Connector JARs need to bring along all necessary dependencies inside the JAR.\n\n## Kibana\n\nA `kibana` profile is available in the provided docker compose files to support inspection and exploration of the Camunda Platform 8 data in Elasticsearch.\nIt can be enabled by adding `--profile kibana` to your docker compose command.\nIn addition to the other components, this profile spins up [Kibana](https://www.elastic.co/kibana/).\nKibana can be used to explore the records exported by Zeebe into Elasticsearch, or to discover the data in Elasticsearch used by the other components (e.g. Operate).\n\nYou can navigate to the Kibana web app and start exploring the data without login credentials:\n\n- Kibana: [http://localhost:5601](http://localhost:5601)\n\n\u003e **Note**\n\u003e You need to configure the index patterns in Kibana before you can explore the data.\n\u003e - Go to `Management \u003e Stack Management \u003e Kibana \u003e Index Patterns`.\n\u003e - Create a new index pattern. For example, `zeebe-record-*` matches the exported records.\n\u003e   - If you don't see any indexes then make sure to export some data first (e.g. deploy a process). The indexes of the records are created when the first record of this type is exported.\n\u003e - Go to `Analytics \u003e Discover` and select the index pattern.\n\n## Desktop Modeler\n\n\u003e :information_source: The Desktop Modeler is [open source, free to use](https://github.com/camunda/camunda-modeler).\n\n[Download the Desktop Modeler](https://camunda.com/download/modeler/) and start modeling BPMN, DMN and Camunda Forms on your local machine.\n\n### Deploy or execute a process\n\n#### Without authentication\nOnce you are ready to deploy or execute processes use these settings to deploy to the local Zeebe instance:\n* Authentication: `None`\n* URL: `http://localhost:26500`\n\n#### With Zeebe request authentication\nIf you enabled authentication for GRPC requests on Zeebe you need to provide client credentials when deploying and executing processes:\n* Authentication: `OAuth`\n* URL: `http://localhost:26500`\n* Client ID: `zeebe`\n* Client secret: `zecret`\n* OAuth URL: `http://localhost:18080/auth/realms/camunda-platform/protocol/openid-connect/token`\n* Audience: `zeebe-api`\n\n## Web Modeler Self-Managed\n\n\u003e :information_source: Web Modeler Self-Managed is available to Camunda enterprise customers only.\n\nThe Docker images for Web Modeler are available in a private registry. Enterprise customers either already have credentials to this registry, or they can request access to this registry through their CSM contact at Camunda.\n\nTo run Camunda Platform with Web Modeler Self-Managed clone this repo and issue the following commands:\n\n```\n$ docker login registry.camunda.cloud\nUsername: your_username\nPassword: ******\nLogin Succeeded\n```\n\n#### To run Camunda Platform with Elasticsearch execute this commands\n\n1. Edit ```.env``` file and set parameter ```SEARCH_DB=elasticserach``` (this default value)\n2. Run command\n```\n$ docker compose -f docker-compose.yaml -f docker-compose-web-modeler.yaml up -d\n```\n3. To tear down the whole environment with ```ElasticSearch``` run the following command\n\n```\n$ docker compose -f docker-compose.yaml -f docker-compose-web-modeler.yaml down -v\n```\n\nIf you want to delete everything (including any data you created).\nAlternatively, if you want to keep the data run:\n\n```\n$ docker compose -f docker-compose.yaml -f docker-compose-web-modeler.yaml down\n```\n\nTo run Camunda Platform with ```OpenSearch``` execute this commands\n\n1. Edit ```.env``` file and set parameter ```SEARCH_DB=opensearch```\n2. Run command\n```\n$ docker compose -f docker-compose.yaml -f docker-compose-web-modeler.yaml --profile opensearch up -d\n```\n3. To tear down the whole environment with Elasticsearch run the following command (-v is optional flag. Use it, if you want to delete all the data)\n\n```\n$ docker compose -f docker-compose.yaml -f docker-compose-web-modeler.yaml --profile opensearch down -v\n```\n\n### Login\nYou can access Web Modeler Self-Managed and log in with the user `demo` and password `demo` at [http://localhost:8070](http://localhost:8070).\n\n### Deploy or execute a process\n\n#### Without authentication\nOnce you are ready to deploy or execute processes use these settings to deploy to the local Zeebe instance:\n* Authentication: `None`\n* URL: `http://zeebe:26500`\n\n#### With Zeebe request authentication\nIf you enabled authentication for GRPC requests on Zeebe you need to provide client credentials when deploying and executing processes:\n* Authentication: `OAuth`\n* URL: `http://zeebe:26500`\n* Client ID: `zeebe`\n* Client secret: `zecret`\n* OAuth URL: `http://keycloak:18080/auth/realms/camunda-platform/protocol/openid-connect/token`\n* Audience: `zeebe-api`\n\n### Emails\nThe setup includes [Mailpit](https://github.com/axllent/mailpit) as a test SMTP server. It captures all emails sent by Web Modeler, but does not forward them to the actual recipients. \n\nYou can access emails in Mailpit's Web UI at [http://localhost:8075](http://localhost:8075).\n\n## Troubleshooting\n\n### Submitting Issues\nWhen submitting an issue on this repository, please make sure your issue is related to the docker compose deployment\nmethod of the Camunda Platform. All questions regarding to functionality of the web applications should be instead\nposted on the [Camunda Forum](https://forum.camunda.io/). This is the best way for users to query for existing answers\nthat others have already encountered. We also have a category on that forum specifically for [Deployment Related Topics](https://forum.camunda.io/c/camunda-platform-8-topics/deploying-camunda-platform-8/33).\n\n### Running on arm64 based hardware\nWhen using arm64-based hardware like a M1 or M2 Mac the Keycloak container might not start because Bitnami only\nprovides amd64-based images for versions \u003c  22. You can build and tag an arm-based\nimage locally using the following command. After building and tagging the image you can start the environment as\ndescribed in [Using docker-compose](#using-docker-compose).\n\n```\n$ DOCKER_BUILDKIT=0 docker build -t bitnami/keycloak:19.0.3 \"https://github.com/camunda/camunda-platform.git#8.2.15:.keycloak/\"\n```\n\n## Resource based authorizations\n\nYou can control access to specific processes and decision tables in Operate and Tasklist with [resource-based authorization](https://docs.camunda.io/docs/self-managed/concepts/access-control/resource-authorizations/).\n\nThis feature is disabled by default and can be enabled by setting \n`RESOURCE_AUTHORIZATIONS_ENABLED` to `true`, either via the [`.env`](.env) file or through the command line:\n\n```\nRESOURCE_AUTHORIZATIONS_ENABLED=true docker compose up -d\n```\n\n## Multi-Tenancy\n\nYou can use [multi-tenancy](https://docs.camunda.io/docs/self-managed/concepts/multi-tenancy/) to achieve tenant-based isolation.\n\nThis feature is disabled by default and can be enabled by setting\n`MULTI_TENANCY_ENABLED` to `true`, either via the [`.env`](.env) file or through the command line:\n\n```\nZEEBE_AUTHENICATION_MODE=identity MULTI_TENANCY_ENABLED=true docker compose up -d\n```\n\nAs seen above the feature also requires you to use `identity` as an authentication provider.\n\nEnsure you [setup tenants in identity](https://docs.camunda.io/docs/self-managed/identity/user-guide/tenants/managing-tenants/) after you start the platform.\n\n## Camunda Platform 7\n\nLooking for information on Camunda Platform 7? Check out the links below:\n\n- [Documentation](https://docs.camunda.org/)\n- [GitHub](https://github.com/camunda/camunda-bpm-platform)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fedwinvw%2Fcamunda-alpha","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fedwinvw%2Fcamunda-alpha","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fedwinvw%2Fcamunda-alpha/lists"}