Skip to content

docs(cli): add Local Proxy page (run multiple shops in parallel) - #2444

Open
Tomasz Turkowski (tturkowski) wants to merge 2 commits into
mainfrom
docs/cli-local-proxy
Open

docs(cli): add Local Proxy page (run multiple shops in parallel)#2444
Tomasz Turkowski (tturkowski) wants to merge 2 commits into
mainfrom
docs/cli-local-proxy

Conversation

@tturkowski

@tturkowski Tomasz Turkowski (tturkowski) commented Aug 14, 2026

Copy link
Copy Markdown
Contributor

What

Adds a new CLI reference page documenting shopware-cli project proxy — running several local Shopware shops at once, each on its own stable HTTPS hostname (e.g. https://my-shop.shopware.local) behind one shared reverse proxy, instead of fighting over fixed host ports.

Relates to the shopware-cli feature in shopware/shopware-cli#1208. Issue shopware/shopware-cli#1094

Page

products/tools/cli/project-commands/local-proxy.md (nav position 2, right after Development Environment):

  • Intro — the port-conflict problem and what the proxy solves
  • How it works — a Mermaid sequence diagram (browser → CoreDNS → Traefik → shop) plus a short explanation (CoreDNS resolver, shared Traefik, local CA)
  • One-time setupproxy setup (the single sudo moment), --domain
  • Two workflows — new project (create --local-domaindev) and existing project (proxy up / down)
  • Command reference — setup / up / down / status / list / verify / teardown, with a proxy list example
  • Choosing the hostname, troubleshooting (proxy verify), requirements (Docker; macOS/Linux; Windows via WSL2)

Linking

  • Cross-linked from dev-environment.md ("Further reading").
  • Added Traefik, WSL2, CoreDNS to .wordlist.txt (sorted) for spellcheck.

Notes

The underlying shopware-cli PR is still in review. Feedback on wording/placement welcome.

@shopware-dev-docs-connector

shopware-dev-docs-connector Bot commented Aug 14, 2026

Copy link
Copy Markdown

Developer Docs healthcheck

Status: Completed with success.
Repository: shopware/docs
Commit: 5f138dd
Preview: https://developer-documentation-1ifpm3d0f-shopware-frontends.vercel.app
Workflow run: #4838

@lasomethingsomething

Copy link
Copy Markdown
Contributor

Heya Micha Hobert (@Isengo1989) and Bojan Rajh (@bojanrajh), this feature is going live in the new CLI release we plan to ship on Monday, Aug. 17. If you have time to take a look, we're greatly appreciate it.

Comment thread products/tools/cli/project-commands/dev-environment.md
Comment thread products/tools/cli/project-commands/local-proxy.md
Comment thread products/tools/cli/project-commands/local-proxy.md
Comment thread products/tools/cli/project-commands/local-proxy.md Outdated
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@github-actions

Copy link
Copy Markdown
Contributor

📢 Developer Announcement Recommendation

Recommendation: ❌ No Announcement Recommended

No developer announcement signals were detected.

This PR does not appear to introduce developer-facing changes that require a community announcement.

@Ant1gua
Anne (Ant1gua) self-requested a review August 14, 2026 16:49

@Isengo1989 Micha Hobert (Isengo1989) 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.

Thanks for the PR Tomasz Turkowski (@tturkowski) 👍

I would go for a different style on the example output with a small hint maybe, but this is subjective. Your call.

Image Image

@Isengo1989 Micha Hobert (Isengo1989) added the Undocumented Feature Feature which is not documented yet and is considered for documentation label Aug 17, 2026
@tturkowski

Copy link
Copy Markdown
Contributor Author

Micha Hobert (@Isengo1989) thank for the comment! I'm not sure if I exactly catch what you mean. Would you be up for giving an example?

@Isengo1989

Copy link
Copy Markdown
Contributor

Micha Hobert (Micha Hobert (@Isengo1989)) thank for the comment! I'm not sure if I exactly catch what you mean. Would you be up for giving an example?

Those above are two screenshots, first -> current , second -> shell instead of text as the codeblock type.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Undocumented Feature Feature which is not documented yet and is considered for documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants