Skip to content

Add Docker Compose support#75

Open
alexandreroman wants to merge 1 commit intotemporalio:mainfrom
alexandreroman:feature/docker-compose-support
Open

Add Docker Compose support#75
alexandreroman wants to merge 1 commit intotemporalio:mainfrom
alexandreroman:feature/docker-compose-support

Conversation

@alexandreroman
Copy link
Copy Markdown

Summary

  • Add references/core/docker-compose.md covering how to run Temporal with Docker Compose (and Podman Compose)
  • Includes minimal compose file, worker integration, healthcheck best practices, and tips for development
  • Update SKILL.md description to trigger on Docker/container-related queries
  • Add cross-reference from dev-management.md to the new Docker Compose guide

Details

This adds a new reference document for running a Temporal dev environment using Docker Compose as an alternative to temporal server start-dev. It covers:

  • Minimal compose.yaml with healthcheck
  • Connecting workers (as containers or from host)
  • Podman Compose compatibility
  • Key ports and configuration tips

Test plan

  • Verify the skill triggers on Docker Compose-related queries (e.g. "add Temporal to Docker Compose")
  • Review references/core/docker-compose.md for accuracy
  • Confirm cross-references from SKILL.md and dev-management.md are correct

@alexandreroman alexandreroman requested a review from a team as a code owner April 10, 2026 21:19
@CLAassistant
Copy link
Copy Markdown

CLAassistant commented Apr 10, 2026

CLA assistant check
All committers have signed the CLA.

@alexandreroman alexandreroman force-pushed the feature/docker-compose-support branch from 095c6ef to f988db3 Compare April 17, 2026 15:48
@alexandreroman alexandreroman force-pushed the feature/docker-compose-support branch from f988db3 to 1eff634 Compare April 17, 2026 21:30
Copy link
Copy Markdown
Collaborator

@donald-pinckney donald-pinckney left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for the PR, and apologies it took a while to get to reviewing it! Love the additions here, Docker support is great. Just one small change requested, in order to help agents decide if/when to use Docker, before loading the Docker file.


It is perfectly OK for this process to be shared across multiple projects / left running as you develop your Temporal code.

Alternatively, you can run Temporal as a Docker Compose service. See `references/core/docker-compose.md` for details.
Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please provide guidance at this point for when the model should / shouldn't use Docker. You already have the content for that elsewhere (You want a reproducible, self-contained...), just move it up here so the model sees that before deciding to load docker-compose.md.

Also, please do keep the guidance as pushing non-docker as the "default" for now.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants