Repository navigation
docs: update Devenv legacy setup for frosh/devenv-meta 0.4 - #2558
Micha Hobert (Isengo1989) merged 3 commits into
Conversation
Bring the Devenv pages in line with the 0.4 recipe and Devenv 2.4: - Create the project and add frosh/devenv-meta with `nix run` Composer, so no PHP or Composer is needed on the host - Require Devenv 2.4+, install it with `nix profile add nixpkgs#devenv` - Document strict ports, automatic DATABASE_URL/MAILER_DSN and the automatically created database and user - MailHog → Mailpit, Adminer port 9080 → 8010, mention Caddy's admin API - Fix demo data instructions (needs shopware/dev-tools; `composer setup` only exists in shopware/shopware) - Add RabbitMQ, OpenSearch and "multiple projects" sections - Use lib.mkForce where the recipe sets values explicitly (MySQL package, Caddy virtual hosts), and update the sales channel domain on port changes - Replace the broken mysql80 overrideAttrs example with a pinned nixpkgs input - Replace non-existent `devenv reload` and the kill-all-Nix-processes command - Fix indentation of all Nix examples and remove nodejs-18_x Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Developer Docs healthcheckStatus: Completed with Fork PRs need approval from a maintainer with write access before the healthcheck can run. GitHub approves only the latest commit, so every new commit pushed after approval needs another approval. |
|
Glad to see updates on a "legacy" setup :) |
There was a problem hiding this comment.
Copilot review overview
🟡 Changes recommended
The multi-project Caddy guidance and custom-domain database command can produce incorrect configurations.
Review effort: Balanced
Findings: 4
Open (4)
What changed in this PR
Updates the legacy Shopware Devenv documentation for frosh/devenv-meta 0.4 and Devenv 2.4.
Changes:
- Updates installation, services, ports, and environment variables.
- Adds RabbitMQ, OpenSearch, and multi-project guidance.
- Adds
nixpkgsto the spellcheck wordlist.
| File | Description |
|---|---|
.wordlist.txt |
Allows the nixpkgs term |
devenv-setup.md |
Updates setup and service documentation |
devenv-options.md |
Expands customization guidance |
💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.
The SQL example hardcoded http://127.0.0.1:8001, which only matched the "Change port only" tab. Use the APP_URL and MYSQL_TCP_PORT variables that Devenv exports instead, so the command matches every example on the page. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Caddy opens all TCP listeners, including the admin API, with SO_REUSEPORT on Unix systems, so multiple Devenv projects share 127.0.0.1:2019. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
|
Thank you for the PR Gregor Lohaus (@GregorLohaus) 👍 |

Summary
Bring the Devenv pages in line with the 0.4 recipe and Devenv 2.4
Related links
pull request
Checklist
PageRefreferences where relevant..gitbook.yamlif pages were moved, renamed, or deleted..wordlist.txt(and sorted it) if spellcheck flags new legitimate terms.Notes
nixpkgsto.wordlist.txt.