Streamlining Shopware Development: DDEV Domains and Plugin Licensing

Streamlining Shopware Development: DDEV Domains and Plugin Licensing

For Shopware developers, setting up a robust local environment is crucial for efficient development and testing. Two popular tools that facilitate this are Dockware and DDEV. While both offer excellent capabilities, a common concern often arises when dealing with licensed plugins: how do these local environments interact with Shopware's licensing system, especially when not using the traditional 'localhost' domain?

The Challenge: Local Development and Licensed Plugins

A developer using Dockware typically benefits from the fact that their local Shopware instance runs on localhost. This domain is generally recognized by Shopware as a development environment, allowing licensed plugins to be tested without triggering license warnings or requiring a separate development license. This simplifies the process of integrating and testing commercial plugins before deployment to a live server.

However, as raised by forum user torstenwolter, the situation becomes less clear when using DDEV. DDEV environments typically provision domains like *.ddev.site. The core question was:

  • Are *.ddev.site domains also treated as development environments by Shopware, similar to localhost, allowing for license-free testing of plugins?
  • Or would developers need to "cumbersomely" configure their DDEV setup to use localhost, or risk triggering "plugins not licensed" emails by using customer license domains for testing?

This concern highlights a practical dilemma: developers need to test plugins thoroughly, including potential "side effects" with existing plugins for various clients, without inadvertently causing licensing issues or administrative overhead.

The Solution: Shopware's Built-in Support for DDEV

Fortunately, the Shopware community and core team have addressed this specific challenge. Forum member marco.steinhaeuser confirmed that, "Doch, das sollte funktionieren." (Yes, that should work.) He further added that if, contrary to expectations, errors were to occur, developers could manually extend a whitelist within Shopware's Admin JavaScript and even suggested submitting a Pull Request for such an enhancement.

The definitive answer and the underlying solution came from shyim, who pointed to a specific GitHub Pull Request:

fix(administration): skip license checks for ddev.site domains by shyim · Pull Request #21387 · shopware/shopware · GitHub

This Pull Request (PR) explicitly details a fix implemented within Shopware's administration to "skip license checks for ddev.site domains." This means that Shopware's core system now officially recognizes *.ddev.site domains as valid development environments where commercial plugins can be tested without requiring active licenses. This is a significant improvement for the developer experience, aligning DDEV's domain structure with Shopware's licensing logic.

Implications for Shopware Developers

This integration brings several key benefits:

  • Streamlined Workflow: Developers using DDEV no longer need to worry about complex workarounds or manual configurations to bypass license checks for local plugin testing.
  • Risk Reduction: The concern of triggering "plugins not licensed" notifications or emails when testing client-specific setups is eliminated.
  • Consistent Testing: It ensures that the local development environment accurately reflects how licensed plugins will behave without artificial constraints.
  • Enhanced Productivity: By removing a common friction point, developers can focus more on building and less on environment configuration.

This thoughtful addition to Shopware's core functionality underscores the platform's commitment to supporting its developer community and fostering efficient development practices. For anyone leveraging DDEV for their Shopware projects, this insight provides clear confirmation and peace of mind regarding plugin licensing.

The community's quick and precise response, backed by a direct link to the official code change, exemplifies the collaborative spirit within the Shopware ecosystem.

Start with the tools

Explore migration tools

See options, compare methods, and pick the path that fits your store.

Explore migration tools