Skip to content

Document migration endpoints and S2S Proxy setup for multiple self-hosted servers - #5043

Open
lukeknep wants to merge 4 commits into
mainfrom
docs/migration-endpoint-cardinality
Open

Document migration endpoints and S2S Proxy setup for multiple self-hosted servers#5043
lukeknep wants to merge 4 commits into
mainfrom
docs/migration-endpoint-cardinality

Conversation

@lukeknep

@lukeknep lukeknep commented Aug 5, 2026

Copy link
Copy Markdown
Contributor

What

Documents how migration endpoints and S2S Proxy deployments map to self-hosted servers in Automated migration.

  • New section, "Plan migration endpoints" (Phase 2): each self-hosted server you migrate from needs its own S2S Proxy deployment and its own migration endpoint. You can migrate from more than one self-hosted server at the same time, provided each has a unique cluster name and Initial Failover Version.
  • Limitations: corrected the cluster-name collision bullet, which omitted the Initial Failover Version requirement, and pointed it at the new section instead of restating it.
  • FAQ: added "Can I migrate from multiple self-hosted servers at the same time?"

Why

A customer migrating separate development and production Temporal Services asked whether they could run those migrations in parallel. The answer is yes, but the docs never explained how endpoints and proxies map to self-hosted servers, so the assumption from the field was that only one server could be connected at a time. The existing Limitations bullet covered the collision case only and omitted the Initial Failover Version requirement.

The guidance is written from the customer's side of the connection. Cloud-side provisioning details are deliberately left out; customers are asked to tell Temporal how many servers they are migrating from and whether those migrations run in parallel.

Testing

  • yarn build passes with no new warnings.
  • Vale not run locally (binary not installed); no headings or relative links changed in ways the CI rules flag.

🤖 Generated with Claude Code

Document that a migration endpoint pairs exactly one self-hosted server
with one migration server, and that a single migration server can hold
multiple endpoints. This allows several self-hosted S2S Proxy
deployments to connect to the same migration server and migrate
Namespaces in parallel, provided each self-hosted server has a unique
cluster name and Initial Failover Version.

Replaces the partial description in Limitations with a pointer to the
new section, and adds an FAQ entry for the question as customers ask it.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@lukeknep
lukeknep requested a review from a team as a code owner August 5, 2026 23:30
@vercel

vercel Bot commented Aug 5, 2026

Copy link
Copy Markdown

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

Project Deployment Actions Updated (UTC)
temporal-documentation Ready Ready Preview Aug 7, 2026 10:33pm

Request Review

Tell Temporal how many self-hosted servers you plan to migrate from and whether those migrations run in parallel, so
that the correct number of endpoints and migration servers can be provisioned.

### S2S Proxy configuration

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

📝 [vale] reported by reviewdog 🐶
[Temporal.Headings] 'S2S Proxy configuration' should use sentence-style capitalization.

@github-actions

github-actions Bot commented Aug 5, 2026

Copy link
Copy Markdown
Contributor

📖 Docs PR preview links

Drop the description of multiple endpoints residing on one cloud-side
migration server, which is internal configuration customers neither
control nor need. Frame the guidance around what the customer does:
one S2S Proxy deployment and one migration endpoint per self-hosted
server, with unique cluster names and Initial Failover Versions when
migrating from several servers at once.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@lukeknep lukeknep changed the title Explain migration endpoint and S2S Proxy cardinality in automated migration Document migration endpoints and S2S Proxy setup for multiple self-hosted servers Aug 6, 2026
Readers were pointing the connectivity test at a cloud-side address, and
the page only answered parallelism for multiple self-hosted servers, not
for multiple Namespaces on one server.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
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.

2 participants