docs: self-hosted setup for serverless workers by lennessyy · Pull Request #4476 · temporalio/documentation

lennessyy · 2026-04-22T23:12:54Z

Summary

Adds a self-hosted setup page covering prerequisites for running Serverless Workers on a self-hosted Temporal Service with AWS Lambda
Covers enabling the Worker Controller via dynamic config, configuring AWS credentials, and creating the Lambda invocation role
Includes a CloudFormation template adapted for self-hosted (uses TemporalIamRoleArn parameter instead of hardcoded Temporal Cloud accounts)

Test plan

Verify the dynamic config keys match the source code in temporal-auto-scaled-workers
Review CloudFormation template with Stefan
Confirm page renders correctly in sidebar

🤖 Generated with Claude Code

┆Attachments: EDU-6254 docs: self-hosted setup for serverless workers

Covers enabling the Worker Controller via dynamic config, configuring AWS credentials for the Temporal server, and creating the Lambda invocation role with a CloudFormation template adapted for self-hosted. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

vercel · 2026-04-22T23:12:59Z

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
temporal-documentation	Ready	Preview, Comment	Apr 28, 2026 5:59pm

github-actions · 2026-04-22T23:13:21Z

📖 Docs PR preview links

Develop
- Go SDK
  - Workers
    - Run a Worker
    - Serverless Workers
      - Serverless Workers on AWS Lambda
- Worker performance
Evaluate
- Serverless Workers
  - Interactive Demo
Production Deployment
- Worker deployments
  - Serverless Workers
    - AWS Lambda
    - Self-hosted setup
Serverless Workers
Sticky Execution
Task Queues
Workers

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Add how to view WCI workflows using TemporalNamespaceDivision filter to both the self-hosted setup page and the deploy guide. Add aws sts get-caller-identity tip for finding the server's IAM ARN. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

lennessyy · 2026-04-23T18:42:27Z

+
+## Enable the Worker Controller {#enable-worker-controller}
+
+The Worker Controller is the server component that monitors Task Queues and invokes compute providers.


Suggested change

The Worker Controller is the server component that monitors Task Queues and invokes compute providers.

The Worker Controller Instance (WCI) is the server component that monitors Task Queues and invokes compute providers.

lennessyy · 2026-04-23T18:42:45Z

+
+The Temporal Service watches the dynamic config file for changes and applies updates without a restart.
+
+### Worker Controller dynamic config reference {#dynamic-config-reference}


This needs to go to dynamic config page, not here.

lennessyy · 2026-04-23T18:43:18Z

+  - Self-hosted
+---
+
+Temporal Cloud handles Serverless Worker infrastructure automatically.


We don't need this first paragraph.

lennessyy · 2026-04-23T18:47:12Z

+
+Use this role ARN when creating the Worker Deployment Version.
+
+## Verify the Worker Controller {#verify-worker-controller}


On second thought I think we don't need this section. Just a ## Next steps section that links to AWS Lambda deploy guide is enough,

- Remove first paragraph (Cloud comparison) - Add brief overview of the three setup steps - Use "Worker Controller Instance (WCI)" instead of "Worker Controller" - Move dynamic config reference table out (belongs on dynamic config page) - Replace verify section with Next steps linking to deploy guide Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

02strich · 2026-04-24T17:59:46Z

+This page covers the prerequisites for running [Serverless Workers](/serverless-workers) on a self-hosted Temporal
+Service with AWS Lambda:
+
+1. Enable the Worker Controller Instance (WCI) on the server through dynamic configuration.


Suggested change

1. Enable the Worker Controller Instance (WCI) on the server through dynamic configuration.

1. Enable the Worker Controller on the server through dynamic configuration.

02strich · 2026-04-24T17:59:56Z

+
+## Enable the Worker Controller {#enable-worker-controller}
+
+The Worker Controller Instance (WCI) is the server component that monitors Task Queues and invokes compute providers. It


Suggested change

The Worker Controller Instance (WCI) is the server component that monitors Task Queues and invokes compute providers. It

The Worker Controller is the server component that monitors Task Queues and invokes compute providers. It

My concern with this is that users will confuse this with https://github.com/temporalio/temporal-worker-controller

These are not the same thing right😅? At least per my understanding these are very different things. But we've already named the Kubernetes thing Worker Controller. Even though this is an internal component, it's a nice one to explain to users so they can understand how it works. It would be great if we can avoid a complete name collision

yeah, our naming in this department has been sub-optimal. Let's leave it as WCI - but make sure that it is always WCI and never worker controller?!

Co-authored-by: Stefan Richter <stefan@02strich.de>

02strich · 2026-04-25T03:52:07Z

+      - no-sync
+```
+
+To enable the Worker Controller for specific Namespaces instead of globally:


Suggested change

To enable the Worker Controller for specific Namespaces instead of globally:

To enable the Worker Controller Instance (WCI) for specific Namespaces instead of globally:

Co-authored-by: Stefan Richter <stefan@02strich.de>

lennessyy requested a review from a team as a code owner April 22, 2026 23:12

vercel Bot deployed to Preview April 22, 2026 23:14 View deployment

docs: add describe-stacks command to retrieve role ARN

6935886

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

vercel Bot deployed to Preview April 23, 2026 01:06 View deployment

vercel Bot deployed to Preview April 23, 2026 02:16 View deployment

docs: remove WCI filter tip from deploy guide

6d7db59

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

vercel Bot deployed to Preview April 23, 2026 17:58 View deployment

lennessyy and others added 2 commits April 23, 2026 10:59

docs: mark IAM section as Cloud-only, link to self-hosted setup

6ac6aa3

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

docs: add (Cloud only) to IAM heading

11fff48

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

vercel Bot deployed to Preview April 23, 2026 18:01 View deployment

docs: move Cloud-only callout to top of IAM section

3b68f71

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

vercel Bot deployed to Preview April 23, 2026 18:03 View deployment

lennessyy commented Apr 23, 2026

View reviewed changes

vercel Bot deployed to Preview April 23, 2026 18:53 View deployment

prettier

c70e028

vercel Bot deployed to Preview April 23, 2026 19:02 View deployment

docs: reference self-hosted setup page in deploy guide prerequisites

4db0b5a

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

vercel Bot deployed to Preview April 23, 2026 19:13 View deployment

02strich reviewed Apr 24, 2026

View reviewed changes

Apply suggestions from code review

a04352b

Co-authored-by: Stefan Richter <stefan@02strich.de>

vercel Bot deployed to Preview April 25, 2026 00:13 View deployment

02strich reviewed Apr 25, 2026

View reviewed changes

Apply suggestions from code review

b29707a

Co-authored-by: Stefan Richter <stefan@02strich.de>

vercel Bot deployed to Preview April 28, 2026 17:33 View deployment

copyedits

1a6b595

vercel Bot deployed to Preview April 28, 2026 17:52 View deployment

copyedits

5a0e86e

vercel Bot deployed to Preview April 28, 2026 17:57 View deployment

correct WCI usage

77f9138

lennessyy merged commit 694c1d1 into feat/serverless-worker-prerelease Apr 28, 2026
6 of 7 checks passed

lennessyy deleted the feat/serverless-worker-oss-prerequisites branch April 28, 2026 17:58

vercel Bot deployed to Preview April 28, 2026 17:59 View deployment


		## Enable the Worker Controller {#enable-worker-controller}

		The Worker Controller is the server component that monitors Task Queues and invokes compute providers.

	The Worker Controller is the server component that monitors Task Queues and invokes compute providers.
	The Worker Controller Instance (WCI) is the server component that monitors Task Queues and invokes compute providers.


		The Temporal Service watches the dynamic config file for changes and applies updates without a restart.

		### Worker Controller dynamic config reference {#dynamic-config-reference}


		Use this role ARN when creating the Worker Deployment Version.

		## Verify the Worker Controller {#verify-worker-controller}

	1. Enable the Worker Controller Instance (WCI) on the server through dynamic configuration.
	1. Enable the Worker Controller on the server through dynamic configuration.

	To enable the Worker Controller for specific Namespaces instead of globally:
	To enable the Worker Controller Instance (WCI) for specific Namespaces instead of globally:

Conversation

lennessyy commented Apr 22, 2026 • edited by sync-by-unito Bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Test plan

Uh oh!

vercel Bot commented Apr 22, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions Bot commented Apr 22, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

📖 Docs PR preview links

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

lennessyy commented Apr 22, 2026 •

edited by sync-by-unito Bot

Loading

vercel Bot commented Apr 22, 2026 •

edited

Loading

github-actions Bot commented Apr 22, 2026 •

edited

Loading