Skip to content

DOC-406: Document DNS workaround for Cloud Pods S3 remotes on older versions - #874

Open
localstack-bot wants to merge 66 commits into
aws-docs-release-augustfrom
docs-agent/doc-406
Open

DOC-406: Document DNS workaround for Cloud Pods S3 remotes on older versions#874
localstack-bot wants to merge 66 commits into
aws-docs-release-augustfrom
docs-agent/doc-406

Conversation

@localstack-bot

@localstack-bot localstack-bot commented Aug 18, 2026

Copy link
Copy Markdown
Collaborator

Summary

Updated the Cloud Pods S3 bucket remote storage documentation to clarify DNS configuration requirements across different LocalStack versions.

Changes

  • Added a version-specific note to the S3 bucket remote storage section (src/content/docs/aws/developer-tools/snapshots/cloud-pods.mdx)
  • Documented that LocalStack v2026.08 or later supports Cloud Pods with real AWS S3 buckets while Transparent Endpoint Injection is enabled
  • Documented the DNS_ADDRESS=0 workaround for older LocalStack versions (before v2026.08) that experience TLS certificate validation errors
  • Added cross-references to related documentation on Transparent Endpoint Injection and DNS Server configuration

Context

PR localstack/localstack-pro#8237 fixed an issue where Cloud Pod saves to real AWS S3 buckets failed with TLS certificate errors when transparent endpoint injection was enabled (the default). Previously, the workaround was to disable the DNS server with DNS_ADDRESS=0, which disabled injection application-wide. The fix uses ExternalBypassDnsClientFactory to correctly route real AWS client requests while keeping injection enabled for user applications.

Audit Trail

Sources Accessed

Coverage Files Parsed

N/A - This is a configuration/capability documentation update, not an AWS service documentation update.

Confidence & Gaps Assessment

  • High confidence: The technical details are well-documented in the Linear ticket and PR description
  • Version assumption: Used v2026.08 as the minimum version based on the ticket creation date (August 2026) and the release pattern (latest documented release is v2026.07). This should be verified against the actual release version when the PR is merged.
  • No gaps identified: The documentation change is straightforward and addresses the specific requirement stated in the ticket

Verification

  • ✅ Build verification: npm run build executed to catch broken links and frontmatter errors
  • ✅ Internal links use root-relative paths
  • ✅ Cross-references added to related DNS and transparent endpoint injection documentation
  • ✅ Followed existing documentation patterns for version-specific notes

Related Documentation

  • Transparent Endpoint Injection: /aws/customization/networking/transparent-endpoint-injection/
  • DNS Server configuration: /aws/customization/networking/dns-server/#dns-server-bind-address

Important

An AI agent generated this pull request. Review all changes before you merge.

quetzalliwrites and others added 30 commits July 9, 2026 15:52
@quetzalliwrites @kostas-localstack @remotesynth
DOCS-349 (hotfix): Release SCIM Entra ID docs updates to production B…
1f5e51c 
…EE 866 (#776)

Co-authored-by: kostas-localstack <konstantinos.koukourakis@localstack.cloud>
Co-authored-by: Brian Rinaldi <brian.rinaldi@gmail.com>
@quetzalliwrites @claude
docs(elb): document ALB multi-listener port-based routing (DOC-310) (#…
fb9f5b5 
…772)

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
@HarshCasper @localstack-bot
Update Azure coverage data (#778)
c20165c 
Co-authored-by: LocalStack Bot <localstack-bot@users.noreply.github.com>
@remotesynth
Add RBAC enforcement documentation (#780)
1e29f8c
@remotesynth
Address known bug in redirects and clean up unneeded ones (#781)
79c8f56
@HarshCasper
docs(aws): remove ACTIVATE_PRO and update GATEWAY_LISTEN defaults (DO…
5af1f84 
…C-331) (#784)
@HarshCasper
fix(snowflake): repair Lambda tutorial dependency install (DOC-336) (#…
50ca401 
…785)
@gtsiolis @claude @quetzalliwrites
docs(lstk hotfix): update CLI reference to v0.16.0 (#788)
234b19a 
Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Co-authored-by: Quetzalli <hola@quetzalliwrites.com>
@HarshCasper
docs(dsql): document CREATE INDEX ASYNC and sys.jobs dialect (DOC-319) (
b070246 
#786)
@remotesynth @quetzalliwrites
@HarshCasper @cursoragent
v2 Getting Started (AWS) (#606)
608a8a5 
Co-authored-by: Quetzalli <hola@quetzalliwrites.com>
Co-authored-by: Quetzalli <alejandra.olvera.novack@gmail.com>
Co-authored-by: Harsh Mishra <erbeusgriffincasper@gmail.com>
Co-authored-by: Cursor <cursoragent@cursor.com>
@quetzalliwrites
DOC-344: add agents.md MVP Docs Agent, LocalStack for AWS docs (#773)
883fdcd
@quetzalliwrites
DOCS (hotfix): LS cli md file should be mdx file (#795)
683c09f
@blkgrlcto
DOC-293 Document dynamic table refresh limitation (#741)
e7d8c14
@HarshCasper @localstack-bot
Update Azure coverage data (#793)
e405d10 
Co-authored-by: LocalStack Bot <localstack-bot@users.noreply.github.com>
@HarshCasper @localstack-bot
Update CloudFormation coverage data (#794)
a97a6b9 
Co-authored-by: LocalStack Bot <localstack-bot@users.noreply.github.com>
@localstack-bot
Update CODEOWNERS (#796)
c858116 
Co-authored-by: LocalStack Bot <localstack-bot@users.noreply.github.com>
@gtsiolis @claude
docs(lstk hotfix): update CLI reference to v0.17.1 (#791)
88d3f02 
Co-authored-by: Claude <noreply@anthropic.com>
@quetzalliwrites @alexrashed
@purcell @kostas-localstack @remotesynth @joe4dev @claude @gtsiolis @blkgrlcto
DOCS: AWS docs release july (#806)
001736d 
Co-authored-by: Alex Rashed <2796604+alexrashed@users.noreply.github.com>
Co-authored-by: Steve Purcell <steve@sanityinc.com>
Co-authored-by: Kostas <konstantinos.koukourakis@localstack.cloud>
Co-authored-by: Brian Rinaldi <brian.rinaldi@gmail.com>
Co-authored-by: Joel Scheuner <joel.scheuner.dev@gmail.com>
Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Co-authored-by: George Tsiolis <tsiolis.g@gmail.com>
Co-authored-by: Kiah Imani <kiah@c-trax.com>
@quetzalliwrites
DOC-359: Add lstk docs to Azure docs (#801)
96b21c8
@gtsiolis @claude
docs(lstk hotfix): update CLI reference to v0.18.0 (#808)
2a0df90 
Co-authored-by: Claude <noreply@anthropic.com>
@quetzalliwrites
DOC-370: Add v2026.07 release to AWS docs changelog (#820)
ba72037
@alexlave100 Alexander
[Replicator] - update docs with current changes (#804)
668cb7f 
Co-authored-by: Alexander <alexander@MacBook-Pro-som-tillhor-Alexander.local>
@quetzalliwrites
DOC-369: Correct stale paths in agents.md (#814)
9ea97ab
@quetzalliwrites
DOC-309: Deprecate legacy CLI support for macOS x86 (#811)
d6a027b
@HarshCasper
DOC-356 (hotfix): Refresh EKS supported versions (#828)
0d368f3
@HarshCasper @localstack-bot
Update Azure coverage data (#824)
7212c03 
Co-authored-by: LocalStack Bot <localstack-bot@users.noreply.github.com>
@HarshCasper @localstack-bot
Update Persistence Docs (#823)
dcfc662 
Co-authored-by: LocalStack Bot <localstack-bot@users.noreply.github.com>
@HarshCasper @localstack-bot
Update Replicator Coverage Docs (#822)
6ae9e96 
Co-authored-by: LocalStack Bot <localstack-bot@users.noreply.github.com>
@quetzalliwrites @remotesynth
DOC-361: Migrate localstack CLI refs to lstk in Azure docs (#803)
2dcd355 
Co-authored-by: Brian Rinaldi <brian.rinaldi@gmail.com>
@quetzalliwrites
DOC-360: Update Azure getting started guide to use lstk (#802)
e0fe9c2
localstack-bot and others added 7 commits August 17, 2026 13:58
@localstack-bot
Update Parity Coverage Docs (#868)
dcf6b16 
Co-authored-by: LocalStack Bot <localstack-bot@users.noreply.github.com>
@localstack-bot
Update CloudFormation coverage data (#869)
074ec4c 
Co-authored-by: LocalStack Bot <localstack-bot@users.noreply.github.com>
@HarshCasper @localstack-bot
DOC-371: Add Docker flags environment variables for container-spawnin…
770f969 
…g services (#846)

Co-authored-by: LocalStack Bot <localstack-bot@users.noreply.github.com>
@blkgrlcto
DOC-279(hotfix): Document pod config support for additional K8s ser…
b998808 
…vices (#839)
@HarshCasper @localstack-bot
Update Azure coverage data (#851)
e540dbd 
Co-authored-by: LocalStack Bot <localstack-bot@users.noreply.github.com>
@blkgrlcto
DOC-302 (hotfix): Add IAM Policy Simulator documentation (#838)
27b0f05
@localstack-bot
DOC-406: automated docs update
8f297de
@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Aug 18, 2026 •
edited
Loading

Copy link
Copy Markdown

Deploying localstack-docs with  Cloudflare Pages  Cloudflare Pages

Latest commit: 8f297de
Status: ✅  Deploy successful!
Preview URL: https://fc7de71f.localstack-docs.pages.dev
Branch Preview URL: https://docs-agent-doc-406.localstack-docs.pages.dev

View logs

@remotesynth
remotesynth requested a review from alexrashed August 19, 2026 11:43
@alexrashed
alexrashed requested review from anisaoshafi and removed request for alexrashed August 19, 2026 11:45
anisaoshafi
anisaoshafi approved these changes Aug 19, 2026
View reviewed changes

@anisaoshafi anisaoshafi left a comment

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.

LGTM, thanks for keeping this up-to-date 🙌🏼

@quetzalliwrites

quetzalliwrites commented Aug 19, 2026

Copy link
Copy Markdown
Collaborator

@anisaoshafi hola chica, can you confirm if this is part of the August release? Or, is this a standalone item we can merge now to main? Thanks!

@anisaoshafi Linear Code

anisaoshafi commented Aug 19, 2026

Copy link
Copy Markdown
Contributor

Hola Quetzalli. This fix was merged 5 days ago. I'm not very up to date with the release process on emulator side. I think we can merge it now, it should be available with latest tag.

@quetzalliwrites

quetzalliwrites commented Aug 19, 2026 •
edited
Loading

Copy link
Copy Markdown
Collaborator

got it @anisaoshafi ... I see ENG merged that code PR into main, so to me this indicates this docs PR it's not release dependent

however, the note itself mentions the upcoming august release, which makes me think merging it on the 26th when we release v2026.7.0 is most logical

@quetzalliwrites
quetzalliwrites changed the base branch from main to aws-docs-release-august August 19, 2026 16:22
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@remotesynth remotesynth remotesynth approved these changes
@quetzalliwrites quetzalliwrites quetzalliwrites approved these changes
@anisaoshafi anisaoshafi anisaoshafi approved these changes
@HarshCasper HarshCasper Awaiting requested review from HarshCasper HarshCasper is a code owner
@viren-nadkarni viren-nadkarni Awaiting requested review from viren-nadkarni viren-nadkarni is a code owner
@k-a-il k-a-il Awaiting requested review from k-a-il k-a-il is a code owner
@alexrashed alexrashed Awaiting requested review from alexrashed alexrashed is a code owner
@silv-io silv-io Awaiting requested review from silv-io silv-io is a code owner
@joe4dev joe4dev Awaiting requested review from joe4dev joe4dev is a code owner
@dfangl dfangl Awaiting requested review from dfangl dfangl is a code owner
@pinzon pinzon Awaiting requested review from pinzon pinzon is a code owner
@nik-localstack nik-localstack Awaiting requested review from nik-localstack nik-localstack is a code owner
@dmacvicar dmacvicar Awaiting requested review from dmacvicar dmacvicar is a code owner

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

9 participants

@localstack-bot @quetzalliwrites @anisaoshafi @remotesynth @HarshCasper @gtsiolis @blkgrlcto @alexlave100 @sheltongraves