docs: update for Docker image restructuring and deprecations #4158

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	Review	Updated (UTC)
temporal-documentation	Ready	Preview, Comment	Jan 28, 2026 10:06pm

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.
1 out of 2 committers have signed the CLA.

✅ tlalfano
❌ 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

Self Hosted Guide

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

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

	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.

docs: update for Docker image restructuring and deprecations #4158

Are you sure you want to change the base?

docs: update for Docker image restructuring and deprecations #4158

Uh oh!

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!

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!

5 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