docs: update for Docker image restructuring and deprecations by tlalfano · Pull Request #4158 · temporalio/documentation

tlalfano · 2026-01-28T21:28:32Z

Summary

Updates documentation for upcoming Docker image changes in Temporal Server 1.30+. These changes reflect the restructuring of Temporal's Docker images to reduce security vulnerabilities, minimize image size, and clarify intended use.

Key Changes

Deprecated Images

temporalio/auto-setup - Deprecated and no longer receiving updates
All references now point to samples-server repository for examples

Server Image Changes (`temporalio/server`)

Documented removal of the following tools:

temporal CLI
dockerize (replaced with embedded sprig)
curl
bash

Admin Tools Image Changes (`temporalio/admin-tools`)

Added documentation for new temporal-elasticsearch-tool

Configuration Changes

Added new "Configuration Templating" section explaining dockerize → sprig migration
Documented template syntax changes (.Env and default function)
Added temporal-server render-config usage

Helm Chart Compatibility

Documented breaking changes in Helm chart version 0.73.1+
Server/admin-tools images 1.30+ require Helm chart 0.73.1 or later
Cannot override existing chart versions with newer images

Files Changed

docs/production-deployment/self-hosted-guide/deployment.mdx
docs/production-deployment/self-hosted-guide/visibility.mdx (5 locations updated)
docs/production-deployment/self-hosted-guide/namespaces.mdx

Notes

Temporal Cloud deployments are not impacted by these changes
All deprecation warnings consistently direct users to samples-server repository for examples

Document breaking changes for upcoming Temporal Server 1.30+ release including auto-setup image deprecation, server/admin-tools image streamlining, dockerize to sprig migration, and Helm chart compatibility requirements to prepare users for the security and maintenance improvements.

vercel · 2026-01-28T21:28:37Z

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

Project	Deployment	Actions	Updated (UTC)
temporal-documentation	Ready	Preview, Comment	Feb 11, 2026 6:24pm

CLAassistant · 2026-01-28T21:28:40Z

Thank you for your submission! We really appreciate it. Like many open source projects, we ask that you all sign our Contributor License Agreement before we can accept your contribution.
2 out of 3 committers have signed the CLA.

✅ tlalfano
✅ lennessyy
❌ Tasha Alfano

Tasha Alfano seems not to be a GitHub user. You need a GitHub account to be able to sign the CLA. If you have already a GitHub account, please add the email address used for this commit to your account.
_{You have signed the CLA already but the status is still pending? Let us recheck it.}

github-actions · 2026-01-28T21:29:00Z

📖 Docs PR preview links

Best Practices
- Worker deployment and performance
Develop
- Dotnet
  - Observability
- Environment configuration
- Go
  - Observability
  - Temporal Client
- Java
  - Observability
  - Temporal Client
- Php
  - Observability
  - Temporal Client
- Python
  - Observability
- Ruby
  - Observability
- Typescript
  - Core application
  - Integrations
    - AI SDK by Vercel integration
  - Observability
References
- Dynamic configuration
Self Hosted Guide
Web UI

chaptersix · 2026-01-28T22:26:39Z

docs/production-deployment/self-hosted-guide/namespaces.mdx

 You must register this Namespace before using it.

-When deploying with Docker Compose or the [auto-setup image](https://github.com/temporalio/docker-builds/blob/main/docker/auto-setup.sh), the `default` Namespace is created automatically.
+:::warning Deprecated: auto-setup Image


I would prefer something more like:

### The default Namespace If no Namespace is specified, SDKs and CLI use the `default` Namespace. You must register this Namespace before using it. For local development, the [`temporal server start-dev`](/cli/server#start-dev) command automatically creates the `default` Namespace. For all other deployment methods, create the `default` Namespace manually using the Temporal CLI: ```bash temporal operator namespace create --namespace default

:::warning Deprecated: auto-setup Image

The temporalio/auto-setup image is deprecated and no longer receives updates.

:::
For setup examples, refer to the samples-server repository and helm-charts repository.

https://github.com/temporalio/samples-server/tree/main/compose

I actually don't think we need this admonition at all. Since we removed the original text there is now no connection between the default namespace and a deprecated deployment artifact and no need to mention it

chaptersix · 2026-01-28T22:28:14Z

docs/production-deployment/self-hosted-guide/visibility.mdx

-The following example shows how the [auto-setup.sh](https://github.com/temporalio/docker-builds/blob/main/docker/auto-setup.sh) script sets up your Visibility store.
+:::warning Deprecated: auto-setup.sh Script
+
+The `auto-setup.sh` script and `temporalio/auto-setup` image are deprecated and no longer receive updates. For setup examples, refer to the [samples-server repository](https://github.com/temporalio/samples-server).


Suggested change

The `auto-setup.sh` script and `temporalio/auto-setup` image are deprecated and no longer receive updates. For setup examples, refer to the [samples-server repository](https://github.com/temporalio/samples-server).

The `auto-setup.sh` script and `temporalio/auto-setup` image are deprecated and no longer receive updates. For setup examples, refer to the [samples-server repository](https://github.com/temporalio/samples-server/tree/main/compose).

same for similar references

chaptersix · 2026-01-28T22:35:41Z

For the complete list of dynamic configuration keys, see https://github.com/temporalio/temporal/blob/main/common/dynamicconfig/constants.go. Ensure that you check server release notes for any changes to these keys and values.

this is not completely true. there are other constants such as those for nexus.

chaptersix · 2026-01-28T22:37:32Z

For the complete list of dynamic configuration keys, see https://github.com/temporalio/temporal/blob/main/common/dynamicconfig/constants.go. Ensure that you check server release notes for any changes to these keys and values.

this is not completely true. there are other constants such as those for nexus.

temporalio/temporal#8676

we should be able to instruct users to run a tdbg or server command to dump all the dynamic configs

chaptersix · 2026-01-28T22:38:36Z

For more examples on how dynamic configuration is set, see:

[docker-compose](https://github.com/temporalio/docker-compose/tree/main/dynamicconfig)

missed a reference

chaptersix · 2026-01-28T22:45:49Z

docs/production-deployment/self-hosted-guide/deployment.mdx

+The `temporalio/server` image has been streamlined to include only production-essential components. The following tools have been removed:
+
+- `temporal` CLI
+- `dockerize` (replaced with embedded `sprig` templating)
+- `curl`
+- `bash`
+
+Configuration templating now uses embedded `sprig` instead of `dockerize`. See [Configuration Templating](#configuration-templating) for details.
+
+:::
+
+The environment variables supported by the Temporal Docker images are documented [on Docker Hub](https://hub.docker.com/r/temporalio/server).


I can't seem to find this section. Does Configuration Templating actually exist?

Ah, search redirects me to that main website

chaptersix · 2026-01-28T22:51:43Z

For the complete list of dynamic configuration keys, see https://github.com/temporalio/temporal/blob/main/common/dynamicconfig/constants.go. Ensure that you check server release notes for any changes to these keys and values.
this is not completely true. there are other constants such as those for nexus.
temporalio/temporal#8676

we should be able to instruct users to run a tdbg or server command to dump all the dynamic configs

no changes required just calling it out

chaptersix · 2026-01-28T22:55:40Z

docs/production-deployment/self-hosted-guide/visibility.mdx

+For Elasticsearch setup, use the `temporal-elasticsearch-tool` available in the `temporalio/admin-tools` image (version 1.30+). For examples, refer to the [samples-server repository](https://github.com/temporalio/samples-server).
+
+:::
+
+The following example shows how to set up an Elasticsearch Visibility store using `temporal-elasticsearch-tool`:


should we just replace the existing examples or have them in a collapsible section?

chaptersix · 2026-01-28T22:56:56Z

docs/production-deployment/self-hosted-guide/deployment.mdx

+
+:::warning Docker Image Changes
+
+The `temporalio/auto-setup` image is **deprecated** and no longer receives updates.


reference to docker compose above should go to samples server.

tlalfano requested a review from a team as a code owner January 28, 2026 21:28

vercel bot deployed to Preview January 28, 2026 21:29 View deployment

tlalfano requested a review from chaptersix January 28, 2026 21:34

docs: add Helm chart configuration options for sprig migration

0b70635

vercel bot deployed to Preview January 28, 2026 21:58 View deployment

docs: add temporal server start-dev as local development alternative

8f18b17

vercel bot deployed to Preview January 28, 2026 22:06 View deployment

chaptersix reviewed Jan 28, 2026

View reviewed changes

lennessyy self-assigned this Jan 29, 2026

lennessyy added 2 commits January 29, 2026 14:51

edits to reduce admonitions

1cb019c

update for readability

8553188

vercel bot deployed to Preview January 29, 2026 23:34 View deployment

docs: small correction

8030466

vercel bot deployed to Preview January 29, 2026 23:40 View deployment

docs: update visibility setup scripts

45c64fa

vercel bot deployed to Preview January 30, 2026 01:54 View deployment

update scripts

fbb4375

vercel bot deployed to Preview January 30, 2026 02:11 View deployment

Docs: provide guidance on helm configuration

d349a71

vercel bot deployed to Preview January 30, 2026 18:10 View deployment

add parameter guidance

4a8a466

vercel bot deployed to Preview January 30, 2026 18:31 View deployment

docs: add snipsync lines

487cb54

vercel bot deployed to Preview January 30, 2026 21:34 View deployment

docs: add snipsync lines

3c8c6b3

vercel bot deployed to Preview January 30, 2026 22:27 View deployment

docs: snipsync update

3c150df

vercel bot deployed to Preview January 30, 2026 23:08 View deployment

docs: remove references to docker compose

6871b65

lennessyy approved these changes Feb 2, 2026

View reviewed changes

Merge branch 'main' into docker-changes-tasha

12765b9

vercel bot deployed to Preview February 2, 2026 20:36 View deployment

Merge branch 'main' into docker-changes-tasha

3bffe89

vercel bot deployed to Preview February 11, 2026 18:24 View deployment

	The `auto-setup.sh` script and `temporalio/auto-setup` image are deprecated and no longer receive updates. For setup examples, refer to the [samples-server repository](https://github.com/temporalio/samples-server).
	The `auto-setup.sh` script and `temporalio/auto-setup` image are deprecated and no longer receive updates. For setup examples, refer to the [samples-server repository](https://github.com/temporalio/samples-server/tree/main/compose).


		:::warning Docker Image Changes

		The `temporalio/auto-setup` image is deprecated and no longer receives updates.

Conversation

tlalfano commented Jan 28, 2026

Summary

Key Changes

Deprecated Images

Server Image Changes (temporalio/server)

Admin Tools Image Changes (temporalio/admin-tools)

Configuration Changes

Helm Chart Compatibility

Files Changed

Notes

Uh oh!

vercel bot commented Jan 28, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

CLAassistant commented Jan 28, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions bot commented Jan 28, 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!

lennessyy Jan 30, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

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!

chaptersix commented Jan 28, 2026

Uh oh!

chaptersix commented Jan 28, 2026

Uh oh!

chaptersix commented Jan 28, 2026

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

chaptersix commented Jan 28, 2026

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

Server Image Changes (`temporalio/server`)

Admin Tools Image Changes (`temporalio/admin-tools`)

vercel bot commented Jan 28, 2026 •

edited

Loading

CLAassistant commented Jan 28, 2026 •

edited

Loading

github-actions bot commented Jan 28, 2026 •

edited

Loading

lennessyy Jan 30, 2026 •

edited

Loading