Skip to content

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

Open
Tomasz Turkowski (tturkowski) wants to merge 1 commit 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 1 commit 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: 670c471
Preview: https://developer-documentation-9n1ht98mb-shopware-frontends.vercel.app
Workflow run: #4832

@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
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.

4 participants