User story
As a developer running multiple Shopware instances in parallel, I want each instance reachable at a stable, dedicated local hostname (e.g. admin.instance1.shopware.local, admin.instance2.shopware.local) instead of differing ports, so I can work with several instances simultaneously without tracking which port maps to which shop.
Problem to solve
With multiple instances, port-based access (localhost:8000, :8001, …) is hard to keep straight and changes as ports shift to avoid collisions. Stable per-instance subdomains make each shop addressable and memorable, and the storefront/admin URLs stay consistent across restarts. This is the OrbStack domain-resolution approach applied to local Shopware dev.
Related to #939 (running multiple shops in parallel / changing ports), but a different mechanism: #939 resolves conflicts by changing ports; this proposes routing by hostname so port juggling is unnecessary.
Origin: suggestion from the SCD audience.
Acceptance criteria
For review and refinement:
Readiness checklist
User story
As a developer running multiple Shopware instances in parallel, I want each instance reachable at a stable, dedicated local hostname (e.g.
admin.instance1.shopware.local,admin.instance2.shopware.local) instead of differing ports, so I can work with several instances simultaneously without tracking which port maps to which shop.Problem to solve
With multiple instances, port-based access (
localhost:8000,:8001, …) is hard to keep straight and changes as ports shift to avoid collisions. Stable per-instance subdomains make each shop addressable and memorable, and the storefront/admin URLs stay consistent across restarts. This is the OrbStack domain-resolution approach applied to local Shopware dev.Related to #939 (running multiple shops in parallel / changing ports), but a different mechanism: #939 resolves conflicts by changing ports; this proposes routing by hostname so port juggling is unnecessary.
Origin: suggestion from the SCD audience.
Acceptance criteria
For review and refinement:
<service>.<instance>.shopware.local)./etc/hostsedits per instance.admin.instance1.shopware.local).APP_URL/ sales-channel domains are set consistently with the assigned hostname.Readiness checklist