v1.23.0: Drupal 11 support, new "drupal" project type, corepack, yarn v4, new defaults

Installation

See the installation instructions for details, but it's easy:

• macOS: brew install ddev/ddev/ddev or just brew upgrade ddev.
• Traditional Windows: Use choco upgrade -y ddev, or download the ddev_windows_installer below.
• Linux or WSL2: Use apt install ddev or apt upgrade ddev see apt/yum installation or use the install_ddev.sh: curl -fsSL https://raw.githubusercontent.com/ddev/ddev/master/scripts/install_ddev.sh | bash
• And anywhere, you can just download the tarball or zipball, untar or unzip it, and place the executable in your $PATH where it belongs.
• Consider ddev delete images or ddev delete images --all after upgrading to free up disk space used by previous docker image versions. This does no harm.
• Consider ddev config --update to update your projects to current configuration.

Highlights:

• Drupal 11 support, including corepack support with corepack_enable: true and automatic detection of the new type.
• ddev-webserver is now upgraded to Debian 12 Bookworm, which means that many newer Debian packages are available.
• Corepack and yarn v4 support.
• New drupal project type to cover Drupal 8+. If you are updating to use type: drupal you may want to use ddev_version_constraint: v1.23.0-alpha1 as well
• New cakephp project type, thanks @ajibarra !
• Laravel 11 support for mariadb database connection.
• ddev pint support for Laravel, thanks @penyaskito !
• Autocompletion for custom/shell commands, thanks @GuySartorelli !
• PHP default version is now 8.2.
• Node.js default version is now 20, thanks @peter-neumann-dev !
• Default database is now mariadb:10.11.
• Traefik Docker image is now 2.11, thanks @nilsandresen !
• ddev composer create is much more compatible with composer create-project, thanks @gilbertsoft !
• ddev launch can open full URLs ddev launch https://ddev.com and custom website ports ddev launch :3000.
• ddev config --update is a new flag. It updates all known .ddev/config.yaml settings based on detected code. Works great for most CMSs and frameworks. It's like ddev config --auto, but ddev config --auto won't change existing settings.
• On WSL2 DDEV uses a different version to figure out host.docker.internal for Xdebug. The new technique seems to work more generally; WSL2 seems to have changed the recommended technique.
• And many, many bug fixes, docs, etc.

Breaking Changes:

• If you update to the new drupal project type, use ddev_version_constraint: v1.23.0-alpha1 as well to notify users of older DDEV versions what the problem is.
• Check your .ddev/config.yaml, namely webimage_extra_packages for compatibility with Debian 12 Bookworm.
• Check your custom Dockerfiles, e.g. if you made some customizations to /etc/apt/sources.list, it has been moved to /etc/apt/sources.list.d/debian.sources with a different structure.
• Python2 support has been removed from upstream, we recommend using an older DDEV if you really need it, see #5928.
• If you have used localhost TLD for your sites, the curl connection between them is broken, see #6040.

Behavior Changes:

• Your DDEV project list is located at ~/.ddev/project_list.yaml, thanks @GuySartorelli !
• CRAFT_WEB_URL has been removed from Craft CMS auto-config as it's not necessary.
• ddev config no longer requires the --create-docroot flag, as it will create docroot automatically.
• Improved performance for ddev xhprof as the XHPROF_FLAGS_CPU flag has been removed by default.
• Platform.sh legacy CLI replaced with the golang-based CLI.
• Our primary recommendation for macOS Docker provider changed to OrbStack.
• Missing projects are automatically removed from the ddev list after notification.
• Website primary URL is correctly set to HTTPS when using custom certificates, thanks @tbmatuka !
• If you happen to downgrade DDEV to v1.22.7 or older it will cause the ddev list to be empty. Don't worry, run ddev start in the project directory and it will reappear in the list.

Bug Fixes:

• Affected version v1.22.7: ddev config could accidentally override your project type to a detected one.
• Affected versions from v1.22.4 to v1.22.7: A race condition could break structure for docker-compose config, thanks @deviantintegral !

Minor Notes:

• Zsh completion instructions are improved, thanks @rpkoller !
• Kirby CMS quickstart, thanks @texnixe !
• Grav CMS quickstart, thanks @rpkoller !
• Pimcore CMS quickstart.
• Symfony Framework quickstart.
• TablePlus support from Setapp directory, thanks @peterkraume !
• DBeaver support in WSL2, thanks @Brupes !
• Magento 2.4.5+ is correctly detected, thanks @Morgy93 !
• DDEV documentation uses bundled external js/css libraries for more privacy, thanks @gitressa !

What's Changed

• docs: Add using current stable version to troubleshooting section by @rfay in #5808
• docs: Revert "docs: temporarily revert docs on not needing --create-docroot" by @rfay in #5768
• test: golangci-lint got pickier, satisfy it by @rfay in #5812
• feat: support TablePlus application located in setapp directory (#5815) by @peterkraume in #5816
• fix: follow the zsh naming conventions for completion scripts by @rpkoller in #5814
• docs: update buildkite installation to include icinga by @rfay in #5802
• docs: show initial and project-checkout Backdrop installation by @tyler36 in #5781
• feat: enable autocompletion for custom commands, fixes #5783 by @GuySartorelli in #5785
• build: bump ddev-php-base and ddev-webserver to base on Debian 12 bookworm, replaces #5278 by @rfay in #5579
• docs: update developer release instructions by @stasadev in #5789
• build: improve goreleaser, add testing capabilities, "head" release, docs, fixes #5821, fixes #5811 by @rfay in #5824
• build: revert implementation of 'head' release, fixes #5830 by @rfay in #5831
• build: bump golangci/golangci-lint-action from 3 to 4 by @dependabot in #5827
• build: bump fuxingloh/multi-labeler from 2 to 3 by @dependabot in #5828
• build: filter binaries for deb and rpm on release, fixes #5734 by @stasadev in #5759
• docs: find all DDEV binaries using which -a ddev by @stasadev in #5834
• docs: update the section about zsh completions by @rpkoller in #5825
• build: bump traefik to 2.11 by @nilsandresen in #5833
• refactor: update to Node.js v20 LTS as current default by @peter-neumann-dev in #5453
• docs: improve buildkite setup for WSL2 by @rfay in #5846
• docs: use PHP 8.3 for the TYPO3 Quickstart by @jonaseberle in #5842
• feat: change php default version to 8.2, fixes #5767 by @rfay in #5835
• docs: add maintainer docs about remote-config testing by @rfay in #5850
• test: silence docker scout nonsense in buildkite [skip ci] by @rfay in #5851
• docs: don't link check a couple of unstable external urls [skip ci] by @rfay in #5852
• fix: make ddev --version work even if not in project and ~/.ddev/commands not yet created by @rfay in #5854
• feat: replace fsouza/go-dockerclient with docker/docker/client, fixes #3460 by @stasadev in #5787
• docs: stop checking all stack overflow links by @rfay in #5858
• docs: mostly warn people off of using xdebug_ide_location by @rfay in #5857
• docs: add auto light / dark mode by @stasadev in #5853
• build: bump fuxingloh/multi-labeler from 3 to 4 by @dependabot in #5867
• docs: buildkite wsl2 setup learning by @rfay in #5864
• docs: stop checking link to community.chocolatey.org by @rfay in #5869
• test: stop testing TestAutocompletionForCustomCmds on Windows, fixes #5870 by @rfay in #5872
• fix: do not create project network programmatically on ddev start, fixes #5810 by @stasadev in #5848
• test: Minor improvement to TestComposerVersion by @rfay in #5879
• test: Fix TestPantheonPush, broken due to php8.2 default by @rfay in #5874
• fix: don't panic in app.Describe() if container not found by @rfay in #5873
• fix: ddev start should not continue if web/db containers aren't healthy by @rfay in #5871
• docs: fix 404 link in phpstorm docs by @rfay in #5881
• docs: Link to 'Upgrading DDEV' in 'Usage' section by @amanire in #5877
• fix: error message 'Error converting to int' on ddev import-db by @rfay in #5856
• f...

v1.23.0-rc2

Installation

See the installation instructions for details, but it's easy:

• macOS: brew install ddev/ddev-edge/ddev or just brew upgrade ddev/ddev-edge/ddev (You may need a brew update for homebrew to find the new release.)
• Linux or WSL2: Download the appropriate deb file from this release and install it with dpkg -i <file>.deb
• Traditional Windows: Use choco upgrade -y --pre ddev to get this one, or download the ddev_windows_installer below.
• And anywhere, you can just download the tarball or zipball, untar or unzip it, and place the executable in your path where it belongs.
• Consider ddev delete images after upgrading to free up disk space used by previous docker image versions. This does no harm.
• Consider ddev config --auto to update your projects to current configuration.

Highlights:

• ddev-webserver is now upgraded to Debian 12 Bookworm, which means that many newer Debian packages are available.
• Corepack and yarn v4 support.
• Drupal 11 support, including corepack support with corepack_enable: true and automatic detection of the new type.
• New drupal project type to cover Drupal 8+.
• New cakephp project type, thanks @ajibarra !
• Laravel 11 support for mariadb database connection.
• ddev pint support for Laravel, thanks @penyaskito !
• Autocompletion for custom/shell commands, thanks @GuySartorelli !
• PHP default version is now 8.2.
• Node.js default version is now 20, thanks @peter-neumann-dev !
• Default database is now mariadb:10.11.
• Traefik Docker image is now 2.11, thanks @nilsandresen !
• ddev composer create is much more compatible with composer create-project, thanks @gilbertsoft !
• ddev launch can open full URLs ddev launch https://ddev.com and custom website ports ddev launch :3000.
• ddev config --update is a new flag. It updates all known .ddev/config.yaml settings based on detected code. Works great for most CMSs and frameworks. It's like ddev config --auto, but ddev config --auto won't change existing settings.
• And many, many bug fixes, docs, etc.

Breaking Changes:

• Check your .ddev/config.yaml, namely webimage_extra_packages and dbimage_extra_packages for compatibility with Debian 12 Bookworm.
• Check your custom Dockerfiles, e.g. if you made some customizations to /etc/apt/sources.list, it has been moved to /etc/apt/sources.list.d/debian.sources with a different structure.
• Python2 support has been removed from upstream, we recommend using an older DDEV if you really need it, see #5928.
• If you have used localhost TLD for your sites, the curl connection between them is broken, see #6040.

Behavior Changes:

• Your DDEV project list is located at ~/.ddev/project_list.yaml, thanks @GuySartorelli !
• CRAFT_WEB_URL has been removed from Craft CMS auto-config as it's not necessary.
• ddev config no longer requires the --create-docroot flag, as it will create docroot automatically.
• Update the deb.sury.org (upstream) package repository key, which will expire on 17 Feb 2024 (a little over a week).
• Improved performance for ddev xhprof as the XHPROF_FLAGS_CPU flag has been removed by default.
• Platform.sh legacy CLI replaced with the latest one.
• Our main recommendation for macOS Docker provider changed to OrbStack.
• Missing projects automatically removed from the ddev list after notification.
• Website primary URL is correctly set to HTTPS when using custom certificates, thanks @tbmatuka !

Bug Fixes:

• Affected version v1.22.7: ddev config could accidentally override your project type to a detected one.
• Affected versions from v1.22.4 to v1.22.7: A race condition could break structure for docker-compose config, thanks @deviantintegral !

Minor Notes:

• Zsh completion instructions are improved, thanks @rpkoller !
• Kirby CMS quickstart, thanks @texnixe !
• Grav CMS quickstart, thanks @rpkoller !
• Pimcore CMS quickstart.
• Symfony Framework quickstart.
• TablePlus support from Setapp directory, thanks @peterkraume !
• DBeaver support in WSL2, thanks @Brupes !
• Magento 2.4.5+ is correctly detected, thanks @Morgy93 !
• DDEV documentation uses bundled external js/css libraries for more privacy, thanks @gitressa !

What's Changed

• docs: Add using current stable version to troubleshooting section by @rfay in #5808
• docs: Revert "docs: temporarily revert docs on not needing --create-docroot" by @rfay in #5768
• test: golangci-lint got pickier, satisfy it by @rfay in #5812
• feat: support TablePlus application located in setapp directory (#5815) by @peterkraume in #5816
• fix: follow the zsh naming conventions for completion scripts by @rpkoller in #5814
• docs: update buildkite installation to include icinga by @rfay in #5802
• docs: show initial and project-checkout Backdrop installation by @tyler36 in #5781
• feat: enable autocompletion for custom commands, fixes #5783 by @GuySartorelli in #5785
• build: bump ddev-php-base and ddev-webserver to base on Debian 12 bookworm, replaces #5278 by @rfay in #5579
• docs: update developer release instructions by @stasadev in #5789
• build: improve goreleaser, add testing capabilities, "head" release, docs, fixes #5821, fixes #5811 by @rfay in #5824
• build: revert implementation of 'head' release, fixes #5830 by @rfay in #5831
• build: bump golangci/golangci-lint-action from 3 to 4 by @dependabot in #5827
• build: bump fuxingloh/multi-labeler from 2 to 3 by @dependabot in #5828
• build: filter binaries for deb and rpm on release, fixes #5734 by @stasadev in #5759
• docs: find all DDEV binaries using which -a ddev by @stasadev in #5834
• docs: update the section about zsh completions by @rpkoller in #5825
• build: bump traefik to 2.11 by @nilsandresen in #5833
• refactor: update to Node.js v20 LTS as current default by @peter-neumann-dev in #5453
• docs: improve buildkite setup for WSL2 by @rfay in #5846
• docs: use PHP 8.3 for the TYPO3 Quickstart by @jonaseberle in #5842
• feat: change php default version to 8.2, fixes #5767 by @rfay in #5835
• docs: add maintainer docs about remote-config testing by @rfay in #5850
• test: silence docker scout nonsense in buildkite [skip ci] by @rfay in #5851
• docs: don't link check a couple of unstable external urls [skip ci] by @rfay in #5852
• fix: make ddev --version work even if not in project and ~/.ddev/commands not yet created by @rfay in #5854
• feat: replace fsouza/go-dockerclient with docker/docker/client, fixes #3460 by @stasadev in #5787
• docs: stop checking all stack overflow links by @rfay in #5858
• docs: mostly warn people off of using xdebug_ide_location by @rfay in #5857
• docs: add auto light / dark mode by @stasadev in #5853
• build: bump fuxingloh/multi-labeler from 3 to 4 by @dependabot in #5867
• docs: buildkite wsl2 setup learning by @rfay in #5864
• docs: stop checking link to community.chocolatey.org by @rfay in #5869
• test: stop testing TestAutocompletionForCustomCmds on Windows, fixes #5870 by @rfay in #5872
• fix: do not create project network programmatically on ddev start, fixes #5810 by @stasadev in #5848
• test: Minor improvement to TestComposerVersion by @rfay in #5879
• test: Fix TestPantheonPush, broken due to php8.2 default by @rfay in #5874
• fix: don't panic in app.Describe() if container not found by @rfay in #5873
• fix: ddev start should not continue if web/db containers aren't healthy by @rfay in #5871
• docs: fix 404 link in phpstorm docs by @rfay in #5881
• docs: Link to 'Upgrading DDEV' in 'Usage' section by @amanire in #5877
• fix: error message 'Error converting to int' on ddev import-db by @rfay in #5856
• fix: cache Docker client instead of creating a new one all the time, fixes #5861 by @stasadev in #5878
• test: exclude TestPHPOverrides on Colima and TestProcessHooks on Windows by @rfay in #5883
• fix: don't start 'mutagen daemon run' during ddev stop/delete by @rfay in #5868
• feat: change database default to mariadb:10.11, fixes #5797 by @rfay in #5836
• test: Run colima tests native instead of github, fixes #5598 by @rfay in #5886
• test: make sure buildkite leaves docker in sane setup by @rfay in https://github.com/ddev/dde...

v1.23.0-rc1

Installation

See the installation instructions for details, but it's easy:

• macOS: brew install ddev/ddev-edge/ddev or just brew upgrade ddev/ddev-edge/ddev (You may need a brew update for homebrew to find the new release.)
• Linux or WSL2: Download the appropriate deb file from this release and install it with dpkg -i <file>.deb
• Traditional Windows: Use choco upgrade -y --pre ddev to get this one, or download the ddev_windows_installer below.
• And anywhere, you can just download the tarball or zipball, untar or unzip it, and place the executable in your path where it belongs.
• Consider ddev delete images after upgrading to free up disk space used by previous docker image versions. This does no harm.
• Consider ddev config --auto to update your projects to current configuration.

Highlights:

• ddev-webserver is now upgraded to Debian 12 Bookworm, which means that many newer Debian packages are available.
• Corepack and yarn v4 support.
• Drupal 11 support, including corepack support with corepack_enable: true and automatic detection of the new type.
• New drupal project type to cover Drupal 8+.
• New cakephp project type, thanks @ajibarra !
• Laravel 11 support for mariadb database connection.
• ddev pint support for Laravel, thanks @penyaskito !
• Autocompletion for custom/shell commands, thanks @GuySartorelli !
• PHP default version is now 8.2.
• Node.js default version is now 20, thanks @peter-neumann-dev !
• Default database is now mariadb:10.11.
• Traefik Docker image is now 2.11, thanks @nilsandresen !
• ddev composer create is much more compatible with composer create-project, thanks @gilbertsoft !
• ddev launch can open full URLs ddev launch https://ddev.com and custom website ports ddev launch :3000.
• ddev config --update is a new flag. It updates all known .ddev/config.yaml settings based on detected code. Works great for most CMSs and frameworks. It's like ddev config --auto, but ddev config --auto won't change existing settings.
• And many, many bug fixes, docs, etc.

Breaking Changes:

• Check your .ddev/config.yaml, namely webimage_extra_packages and dbimage_extra_packages for compatibility with Debian 12 Bookworm.
• Check your custom Dockerfiles, e.g. if you made some customizations to /etc/apt/sources.list, it has been moved to /etc/apt/sources.list.d/debian.sources with a different structure.
• Python2 support has been removed from upstream, we recommend using an older DDEV if you really need it, see #5928.
• If you have used localhost TLD for your sites, the curl connection between them is broken, see #6040.

Behavior Changes:

• Your DDEV project list is located at ~/.ddev/project_list.yaml, thanks @GuySartorelli !
• CRAFT_WEB_URL has been removed from Craft CMS auto-config as it's not necessary.
• ddev config no longer requires the --create-docroot flag, as it will create docroot automatically.
• Update the deb.sury.org (upstream) package repository key, which will expire on 17 Feb 2024 (a little over a week).
• Improved performance for ddev xhprof as the XHPROF_FLAGS_CPU flag has been removed by default.
• Platform.sh legacy CLI replaced with the latest one.
• Our main recommendation for macOS Docker provider changed to OrbStack.
• Missing projects automatically removed from the ddev list after notification.
• Website primary URL is correctly set to HTTPS when using custom certificates, thanks @tbmatuka !

Bug Fixes:

• Affected version v1.22.7: ddev config could accidentally override your project type to a detected one.
• Affected versions from v1.22.4 to v1.22.7: A race condition could break structure for docker-compose config, thanks @deviantintegral !

Minor Notes:

• Zsh completion instructions are improved, thanks @rpkoller !
• Kirby CMS quickstart, thanks @texnixe !
• Grav CMS quickstart, thanks @rpkoller !
• Pimcore CMS quickstart.
• Symfony Framework quickstart.
• TablePlus support from Setapp directory, thanks @peterkraume !
• DBeaver support in WSL2, thanks @Brupes !
• Magento 2.4.5+ is correctly detected, thanks @Morgy93 !
• DDEV documentation uses bundled external js/css libraries for more privacy, thanks @gitressa !

What's Changed

• docs: Add using current stable version to troubleshooting section by @rfay in #5808
• docs: Revert "docs: temporarily revert docs on not needing --create-docroot" by @rfay in #5768
• test: golangci-lint got pickier, satisfy it by @rfay in #5812
• feat: support TablePlus application located in setapp directory (#5815) by @peterkraume in #5816
• fix: follow the zsh naming conventions for completion scripts by @rpkoller in #5814
• docs: update buildkite installation to include icinga by @rfay in #5802
• docs: show initial and project-checkout Backdrop installation by @tyler36 in #5781
• feat: enable autocompletion for custom commands, fixes #5783 by @GuySartorelli in #5785
• build: bump ddev-php-base and ddev-webserver to base on Debian 12 bookworm, replaces #5278 by @rfay in #5579
• docs: update developer release instructions by @stasadev in #5789
• build: improve goreleaser, add testing capabilities, "head" release, docs, fixes #5821, fixes #5811 by @rfay in #5824
• build: revert implementation of 'head' release, fixes #5830 by @rfay in #5831
• build: bump golangci/golangci-lint-action from 3 to 4 by @dependabot in #5827
• build: bump fuxingloh/multi-labeler from 2 to 3 by @dependabot in #5828
• build: filter binaries for deb and rpm on release, fixes #5734 by @stasadev in #5759
• docs: find all DDEV binaries using which -a ddev by @stasadev in #5834
• docs: update the section about zsh completions by @rpkoller in #5825
• build: bump traefik to 2.11 by @nilsandresen in #5833
• refactor: update to Node.js v20 LTS as current default by @peter-neumann-dev in #5453
• docs: improve buildkite setup for WSL2 by @rfay in #5846
• docs: use PHP 8.3 for the TYPO3 Quickstart by @jonaseberle in #5842
• feat: change php default version to 8.2, fixes #5767 by @rfay in #5835
• docs: add maintainer docs about remote-config testing by @rfay in #5850
• test: silence docker scout nonsense in buildkite [skip ci] by @rfay in #5851
• docs: don't link check a couple of unstable external urls [skip ci] by @rfay in #5852
• fix: make ddev --version work even if not in project and ~/.ddev/commands not yet created by @rfay in #5854
• feat: replace fsouza/go-dockerclient with docker/docker/client, fixes #3460 by @stasadev in #5787
• docs: stop checking all stack overflow links by @rfay in #5858
• docs: mostly warn people off of using xdebug_ide_location by @rfay in #5857
• docs: add auto light / dark mode by @stasadev in #5853
• build: bump fuxingloh/multi-labeler from 3 to 4 by @dependabot in #5867
• docs: buildkite wsl2 setup learning by @rfay in #5864
• docs: stop checking link to community.chocolatey.org by @rfay in #5869
• test: stop testing TestAutocompletionForCustomCmds on Windows, fixes #5870 by @rfay in #5872
• fix: do not create project network programmatically on ddev start, fixes #5810 by @stasadev in #5848
• test: Minor improvement to TestComposerVersion by @rfay in #5879
• test: Fix TestPantheonPush, broken due to php8.2 default by @rfay in #5874
• fix: don't panic in app.Describe() if container not found by @rfay in #5873
• fix: ddev start should not continue if web/db containers aren't healthy by @rfay in #5871
• docs: fix 404 link in phpstorm docs by @rfay in #5881
• docs: Link to 'Upgrading DDEV' in 'Usage' section by @amanire in #5877
• fix: error message 'Error converting to int' on ddev import-db by @rfay in #5856
• fix: cache Docker client instead of creating a new one all the time, fixes #5861 by @stasadev in #5878
• test: exclude TestPHPOverrides on Colima and TestProcessHooks on Windows by @rfay in #5883
• fix: don't start 'mutagen daemon run' during ddev stop/delete by @rfay in #5868
• feat: change database default to mariadb:10.11, fixes #5797 by @rfay in #5836
• test: Run colima tests native instead of github, fixes #5598 by @rfay in #5886
• test: make sure buildkite leaves docker in sane setup by @rfay in https://github.com/ddev/dde...

v1.23.0-beta1

Installation

See the installation instructions for details, but it's easy:

• macOS: brew install ddev/ddev-edge/ddev or just brew upgrade ddev/ddev-edge/ddev (You may need a brew update for homebrew to find the new release.)
• Linux or WSL2: Download the appropriate deb file from this release and install it with dpkg -i <file>.deb
• Traditional Windows: Use choco upgrade -y --pre ddev to get this one, or download the ddev_windows_installer below.
• And anywhere, you can just download the tarball or zipball, untar or unzip it, and place the executable in your path where it belongs.
• Consider ddev delete images after upgrading to free up disk space used by previous docker image versions. This does no harm.
• Consider ddev config --auto to update your projects to current configuration.

Highlights:

• ddev-webserver is now upgraded to Debian 12 Bookworm, which means that many newer Debian packages are available.
• Drupal 11 support, including corepack support with corepack_enable: true
• New drupal project type to cover Drupal 8+
• New cakephp project type, thanks @ajibarra !
• Laravel 11 support for mariadb database connection
• Autocompletion for custom/shell commands, thanks @GuySartorelli !
• PHP default version is now 8.2
• Node.js default version is now 20, thanks @peter-neumann-dev !
• Default database is now mariadb:10.11
• Traefik Docker image is now 2.11, thanks @nilsandresen !
• ddev composer create is much more compatible with composer create-project, thanks @gilbertsoft !
• And many, many bug fixes, docs, etc.

Behavior Changes:

• CRAFT_WEB_URL has been removed from Craft CMS auto-config as it's not necessary
• ddev config no longer requires the --create-docroot flag, as it will create docroot automatically.
• Update the deb.sury.org (upstream) package repository key, which will expire on 17 Feb 2024 (a little over a week).
• Improved performance for ddev xhprof as the XHPROF_FLAGS_CPU flag has been removed by default
• Platform.sh legacy CLI replaced with the latest one
• Our main recommendation for macOS Docker provider changed to OrbStack
• Missing projects automatically removed from the ddev list after notification
• If you made some customizations to /etc/apt/sources.list in a custom Dockerfile, it has been moved to /etc/apt/sources.list.d/debian.sources with a different structure.
• Website primary URL is correctly set to HTTPS when using custom certificates, thanks @tbmatuka !

Bug Fixes:

• Affected version v1.22.7: ddev config could accidentally override your project type to a detected one
• Affected versions from v1.22.4 to v1.22.7: A race condition could break structure for docker-compose config, thanks @deviantintegral !

Minor Notes:

• Zsh completion instructions are improved, thanks @rpkoller !
• Kirby CMS quickstart, thanks @texnixe !
• Grav CMS quickstart, thanks @rpkoller !
• Pimcore CMS quickstart
• TablePlus support from Setapp directory, thanks @peterkraume !
• DBeaver support in WSL2, thanks @Brupes !
• Magento 2.4.5+ is correctly detected, thanks @Morgy93 !
• DDEV documentation uses bundled external js/css libraries for more privacy, thanks @gitressa !

What's Changed since v1.23.0-alpha1

• docs: add privacy plugins to not use external fonts, fixes #4982 by @gitressa in #6027
• docs: update CakePHP docs to include a link and instructions for 3.x by @ajibarra in #6021
• fix: rsync example should create db.sql.gz [skip ci] by @rfay in #6022
• fix: revert removal of Colima host.docker.internal setting by @rfay in #6031
• test: make circleci setup noninteractive so doesn't hang [skip buildkite] by @rfay in #6034
• fix: clean up missing project if it's gone, fixes #5322 by @rfay in #6029
• fix: handle wildcard hostnames when name resolution not available, fixes #4881 by @rfay in #6025
• test: try to fix sshfs-based failures on TestGetProjectsMissingApp by @rfay in #6041
• feat: more readable formatting of lists of files, fixes #5985 by @penyaskito in #6030
• build: bump actions/setup-python from 5.0.0 to 5.1.0 by @dependabot in #6038
• fix: ddev debug configyaml shouldn't double-report upload_dirs, fixes #6036 by @rfay in #6037
• feat: Keep hub.docker.com repositories updated, fixes #5847 [skip ci] by @rfay in #6032
• refactor: Use project_list.yaml as source of truth, fixes #5918 by @GuySartorelli in #5926
• fix: shutdown supervisor in healthcheck.sh on fatal error, fixes #5993 by @stasadev in #6033
• fix: Remove Craft CMS PHP version override by @AugustMiller in #5805
• docs: add a sticky warning about the latest version by @stasadev in #6048
• fix: make sure CGO_ENABLED is normally off, fixes #6046 by @rfay in #6050
• feat: Improve container errors messages format, fixes #6042 by @penyaskito in #6043

Full Changelog: v1.23.0-alpha1...v1.23.0-beta1

v1.23.0-alpha1: Drupal 11 support, `drupal` and `cakephp` project types

Installation/Upgrade

See the installation instructions for details, but it's easy:

• macOS: brew install ddev/ddev-edge/ddev or just brew upgrade ddev/ddev-edge/ddev (You may need a brew update for homebrew to find the new release.)
• Linux or WSL2: Download the appropriate deb file from this release and install it with dpkg -i <file>.deb
• Traditional Windows: Use choco upgrade -y --pre ddev to get this one, or download the ddev_windows_installer below.
• And anywhere, you can just download the tarball or zipball, untar or unzip it, and place the executable in your path where it belongs.
• Consider ddev delete images after upgrading to free up disk space used by previous docker image versions. This does no harm.

Highlights:

• ddev-webserver is now upgraded to Debian 12 Bookworm, which means that many newer Debian packages are available.
• Drupal 11 support, including corepack support with corepack_enable: true
• New drupal project type to cover Drupal 8+
• New cakephp project type, thanks @ajibarra!
• Autocompletion for custom/shell commands, thanks @GuySartorelli !
• PHP default version is now 8.2
• Default database is now mariadb:10.11
• ddev composer create is much more compatible with composer create-project, thanks @gilbertsoft !
• And many, many bug fixes, docs, etc.

Caveats

• Xdebug is broken in Colima in this version. It will be fixed in #6031

What's Changed

• docs: Add using current stable version to troubleshooting section by @rfay in #5808
• docs: Revert "docs: temporarily revert docs on not needing --create-docroot" by @rfay in #5768
• test: golangci-lint got pickier, satisfy it by @rfay in #5812
• feat: support TablePlus application located in setapp directory (#5815) by @peterkraume in #5816
• fix: follow the zsh naming conventions for completion scripts by @rpkoller in #5814
• docs: update buildkite installation to include icinga by @rfay in #5802
• docs: show initial and project-checkout Backdrop installation by @tyler36 in #5781
• feat: enable autocompletion for custom commands, fixes #5783 by @GuySartorelli in #5785
• build: bump ddev-php-base and ddev-webserver to base on Debian 12 bookworm, replaces #5278 by @rfay in #5579
• docs: update developer release instructions by @stasadev in #5789
• build: improve goreleaser, add testing capabilities, "head" release, docs, fixes #5821, fixes #5811 by @rfay in #5824
• build: revert implementation of 'head' release, fixes #5830 by @rfay in #5831
• build: bump golangci/golangci-lint-action from 3 to 4 by @dependabot in #5827
• build: bump fuxingloh/multi-labeler from 2 to 3 by @dependabot in #5828
• build: filter binaries for deb and rpm on release, fixes #5734 by @stasadev in #5759
• docs: find all DDEV binaries using which -a ddev by @stasadev in #5834
• docs: update the section about zsh completions by @rpkoller in #5825
• build: bump traefik to 2.11 by @nilsandresen in #5833
• refactor: update to Node.js v20 LTS as current default by @peter-neumann-dev in #5453
• docs: improve buildkite setup for WSL2 by @rfay in #5846
• docs: use PHP 8.3 for the TYPO3 Quickstart by @jonaseberle in #5842
• feat: change php default version to 8.2, fixes #5767 by @rfay in #5835
• docs: add maintainer docs about remote-config testing by @rfay in #5850
• test: silence docker scout nonsense in buildkite [skip ci] by @rfay in #5851
• docs: don't link check a couple of unstable external urls [skip ci] by @rfay in #5852
• fix: make ddev --version work even if not in project and ~/.ddev/commands not yet created by @rfay in #5854
• feat: replace fsouza/go-dockerclient with docker/docker/client, fixes #3460 by @stasadev in #5787
• docs: stop checking all stack overflow links by @rfay in #5858
• docs: mostly warn people off of using xdebug_ide_location by @rfay in #5857
• docs: add auto light / dark mode by @stasadev in #5853
• build: bump fuxingloh/multi-labeler from 3 to 4 by @dependabot in #5867
• docs: buildkite wsl2 setup learning by @rfay in #5864
• docs: stop checking link to community.chocolatey.org by @rfay in #5869
• test: stop testing TestAutocompletionForCustomCmds on Windows, fixes #5870 by @rfay in #5872
• fix: do not create project network programmatically on ddev start, fixes #5810 by @stasadev in #5848
• test: Minor improvement to TestComposerVersion by @rfay in #5879
• test: Fix TestPantheonPush, broken due to php8.2 default by @rfay in #5874
• fix: don't panic in app.Describe() if container not found by @rfay in #5873
• fix: ddev start should not continue if web/db containers aren't healthy by @rfay in #5871
• docs: fix 404 link in phpstorm docs by @rfay in #5881
• docs: Link to 'Upgrading DDEV' in 'Usage' section by @amanire in #5877
• fix: error message 'Error converting to int' on ddev import-db by @rfay in #5856
• fix: cache Docker client instead of creating a new one all the time, fixes #5861 by @stasadev in #5878
• test: exclude TestPHPOverrides on Colima and TestProcessHooks on Windows by @rfay in #5883
• fix: don't start 'mutagen daemon run' during ddev stop/delete by @rfay in #5868
• feat: change database default to mariadb:10.11, fixes #5797 by @rfay in #5836
• test: Run colima tests native instead of github, fixes #5598 by @rfay in #5886
• test: make sure buildkite leaves docker in sane setup by @rfay in #5897
• docs: point to HEAD version of TestSites array by @diegoe in #5895
• docs: show a warning banner for the latest docs (readthedocs+mkdocs) by @stasadev in #5855
• feat: change upgrade pester interval to 4 hours, for #5889 by @rfay in #5890
• feat: make ddev composer create fully compatible with composer create-project by @gilbertsoft in #5058
• test: more buildkite work, windows not working [skip ci] by @rfay in #5902
• fix: set permissions on /run/php so php-fpm can run by @stasadev in #5900
• docs: update Debugging & Profiling for recent updates to phpstorm ui by @vanWittlaer in #5903
• docs: improve database type and version visibility by @tyler36 in #5884
• fix: make a copy of the bytes array before passing to the channel, fixes #5470 by @deviantintegral in #5893
• docs: add instructions for Grav CMS to quickstart.md by @rpkoller in #5796
• docs: add kirby to cms quickstart instructions by @texnixe in #5791
• docs: fix systemd unit example for casual hosting by @vanWittlaer in #5876
• refactor: point go code to the stable docs by @stasadev in #5905
• fix: ddev config should not change unspecified options, fixes #5882 by @stasadev in #5887
• docs: mention more Docker providers for macOS by @stasadev in #5914
• docs: Add Pimcore quickstart, fixes #5843 by @rfay in #5909
• docs: Use backticks when referencing custom command annotations, fixes #5820 by @GuySartorelli in #5927
• docs: update faq with new questions, fix menus by @rfay in #5924
• docs: fix extraneous '#' in FAQ by @rfay in #5930
• fix: magento2 requires mariadb 10.6, for #5919 by @rfay in #5922
• docs: remove 'just' by @rfay in #5933
• docs: standardize capitalization of Docker-ce by @tyler36 in #5934
• docs: use stable URL for 404 [skip ci] by @stasadev in #5931
• fix: add nginx support for webp images in hidden directory, sync nginx conf by @stephanie-ehrling in #5580
• feat: invoke dbeaver inside wsl2, fixes #5375 by @Brupes in #5916
• fix: don't call app.WriteConfig twice by @rfay in #5923
• fix: isMagento2App() ...

v1.22.7: PHP 8.3.2, fixed xdebug, prevent expiring keys

Installation

See the installation instructions for details, but it's easy:

• macOS: brew install ddev/ddev/ddev or just brew upgrade ddev.
• Traditional Windows: Use choco upgrade -y ddev, or download the ddev_windows_installer below.
• Linux or WSL2: Use apt install ddev or apt upgrade ddev see apt/yum installation or use the install_ddev.sh: curl -fsSL https://raw.githubusercontent.com/ddev/ddev/master/scripts/install_ddev.sh | bash
• And anywhere, you can just download the tarball or zipball, untar or unzip it, and place the executable in your $PATH where it belongs.
• Consider ddev delete images or ddev delete images --all after upgrading to free up disk space used by previous docker image versions. This does no harm.
• Consider ddev config --auto to update your projects to current configuration.

Highlights:

• PHP 8.3.2
• Updated xdebug to 3.3.1, which solves the xdebug crash problem described in #5633.
• Updated and improved autocomplete behavior by @GuySartorelli , thanks!
• Improved TablePlus support, including WSL2 support and showing environment information
• ddev pull platform can now pull from a specific app
• Improved ddev pull acquia

Behavior Changes:

• CRAFT_WEB_URL has been removed from Craft CMS auto-config as it's not necessary
• ddev config no longer requires the --create-docroot flag, as it will create docroot automatically.
• Update the deb.sury.org (upstream) package repository key, which will expire on 17 Feb 2024 (a little over a week).
• Improved performance for ddev xhprof as the XHPROF_FLAGS_CPU flag has been removed by default

NOTE TO v1.22.6 users on deb.sury.org key

If you want to keep using DDEV v1.22.6, you can get a new version of the ddev-webserver that has the updated key using docker pull ddev/ddev-webserver:v1.22.6, see #5795 .

Caveats:

• Drupal xdebug users: There is a very obscure Drupal 10 bug which causes "Transaction autocommit during shutdown relies on unreliable object destruction order" when xdebug 3.3+ is enabled. You'll want to read the issue and be aware.

What's Changed

• build: update .gitpod.yml for v1.22.6 release [skip ci] by @stasadev in #5628
• docs: add more troubleshooting for docker build-time errors by @rfay in #5629
• ci: rancher desktop test only on master [skip ci] by @rfay in #5636
• docs: update discord link [skip ci] by @rfay in #5637
• docs: update and reorganize readme.md by @bmartinez287 in #5513
• docs: link to experimental CMS quickstarts by @jeroenpeters1986 in #5638
• build: bump actions/upload-artifact from 3 to 4 by @dependabot in #5648
• refactor: add quotes for the hostname error for better visibility by @stasadev in #5645
• docs: add missing blank lines to readme.md, for #5513 by @stasadev in #5649
• docs: GitHub Codespaces: Adjust examples to make sure docker is running by @eiriksm in #5592
• docs: fix typo in sharing.md by @JorenRothman in #5654
• ci: fix PostgreSQL client for testbot on WSL2 by @stasadev in #5657
• fix: disable Content-Type auto-detection for Traefik 2, fixes #5346 by @stasadev in #5647
• fix: global project_tld should default to 'ddev.site', not empty, fixes #4290 by @rfay in #5632
• fix: update global schema by @tyler36 in #5653
• fix: stop warning about empty app type or docroot creation, fixes #5498 by @rfay in #5631
• build: update all vendor module dependencies by @stasadev in #5658
• feat: add mailpit command (alias of launch -m), fixes #5627 by @GuySartorelli in #5642
• build: revert bump actions/upload-artifact from 3 to 4, for #5648 by @stasadev in #5662
• fix: make sure wsl v2 is used, not wsl v1, fixes #5667 [skip ci] by @rfay in #5670
• docs: fix broken numeration in Pantheon by @stasadev in #5679
• docs: fix composer command code block by @mttsch in #5678
• docs: fix name of HeidiSQL executable by @mttsch in #5677
• docs: update links for VSCode step-debugging extensions by @Nick-Hope in #5699
• build: bump github.com/cloudflare/circl from 1.3.6 to 1.3.7 by @dependabot in #5683
• refactor: move projects list into its own yaml file, fixes #5639 by @GuySartorelli in #5651
• docs: temporarily revert docs on not needing --create-docroot by @rfay in #5716
• docs: fix gitpod PR link by @rfay in #5719
• fix: Add correct mime types for Javascript by @jonnitto in #5661
• fix: remove CRAFT_WEB_URL, fixes #5665 by @timkelty in #5668
• fix: remove --json-output flag from logs command, fixes #962 by @GuySartorelli in #5695
• docs: Overhaul Shell Completion & Autocomplete documentation by @Nick-Hope in #5701
• feat: allow global host commands to be run from anywhere, for #4416 by @GuySartorelli in #5702
• fix: use init option to prevent zombie ddev-router, for #5705 by @stasadev in #5707
• fix: acli output has changed, capture the output file correctly, fixes #5697 by @rfay in #5714
• docs: expand docs on PHP extension installation, including pecl by @rfay in #5715
• docs: fix localdev foundation -> DDEV foundation, for #4848 by @rfay in #5718
• fix: make xhprof faster, fixes #5712 by @LionsAd in #5721
• feat: Platform.sh specific app pull, fixes #5727 by @nir-riskified in #5728
• docs: Update Drupal 9 & 10 CMS Quickstarts by @Nick-Hope in #5733
• feat: add WSL2 support to tableplus command by @plebward in #5738
• feat: add environment and name to TablePlus command by @marten-wirelab in #5741
• docs: use Stack Overflow email filter for maintainers by @stasadev in #5764
• build: bump peter-evans/create-issue-from-file from 4 to 5 by @dependabot in #5752
• build: bump styfle/cancel-workflow-action from 0.12.0 to 0.12.1 by @dependabot in #5751
• fix: update project schema nodejs_version, for #5400 by @stasadev in #5758
• fix: wording on install docs home page about Docker providers should be more generic by @joachim-n in #5754
• docs: added sql:sanitize to Drupal hook examples. by @karenmurky in #5737
• build: bump actions/cache from 3 to 4 by @dependabot in #5724
• docs: use zero width non joiner for markdownlint by @stasadev in #5765
• build: bump docker-compose to v2.24.5, set healthcheck.start_interval to 1s in Docker v25+ by @stasadev in #5745
• test: bump docker-login buildkite plugin to 3.0.0 by @rfay in #5769
• build: update runc, replaces #5760 by @rfay in #5766
• test: Revert "test: bump docker-login buildkite plugin to 3.0.0" by @rfay in #5776
• feat: add autocomplete for project name arguments, fixes #4880 by @GuySartorelli in #5732
• test: only test macos amd64 on master by @rfay in #5779
• test: CircleCI upgrade to go v1.21 by @rfay in #5780
• docs: auto-enable/disable Xdebug when step debugging with VS Code by @jameswilson in #5771
• fix: remove redundant chown in ddev-webserver start.sh, for #4942 by @rfay in #5686
• fix: when settings files not set, don't chmod, fixes #5675 by @rfay in #5676
• fix: nodejs in web container should be link to /usr/local/bin/node by @rfay in #5774
• build: Use new tag to get new deb.sury.org key (and updated php versions), fixes #5788 by @rfay in #5790
• feat: get completion for composer commands by @GuySartorelli in #5756
• build: bump images to v1.22.7 for release, fixes #5633 by @rfay in #5798

New Contributors

• @eiriksm made their first contribution in #5592
• @JorenRothman made their first contribution in #5654
• @mttsch made their first contribution in #5678
• @Nick-Hope made their first contrib...

v1.22.6

Installation

See the installation instructions for details, but it's easy:

• macOS: brew install ddev/ddev/ddev or just brew upgrade ddev.
• Traditional Windows: Use choco upgrade -y ddev, or download the ddev_windows_installer below.
• Linux or WSL2: Use apt install ddev or apt upgrade ddev see apt/yum installation or use the install_ddev.sh: curl -fsSL https://raw.githubusercontent.com/ddev/ddev/master/scripts/install_ddev.sh | bash
• And anywhere, you can just download the tarball or zipball, untar or unzip it, and place the executable in your $PATH where it belongs.
• Consider ddev delete images or ddev delete images --all after upgrading to free up disk space used by previous docker image versions. This does no harm.
• Consider ddev config --auto to update your projects to current configuration.

Highlights:

• PHP 8.3.0 with more extensions: added memcached, redis, and xdebug.
• Host custom commands no longer start the project automatically, DDEV add-ons that rely on this should be updated, see example.
• Fixed regression for Gitpod introduced in v1.22.5 (missing MTU value).

Behavior Changes:

• Help commands respect --json-output flag, thanks to @GuySartorelli
• ddev composer no longer starts debugging with ddev xdebug on.
• New switch ddev xdebug toggle, thanks to @GuySartorelli

What's Changed

• build: update .gitpod.yml for v1.22.5 release [skip ci] by @stasadev in #5576
• ci: don't set default context to default - fix rancher desktop failures by @rfay in #5577
• docs: add note about needing to restart for global commands to be picked up by @joachim-n in #5582
• docs: add more maintainer/privilege info to maintainers doc, buildkite setup by @rfay in #5584
• docs: remove search suggestions and share by @rfay in #5588
• ci: make TestMailpit and TestProjectPortOverride more forgiving of Rancher Desktop, fixes #5578 by @rfay in #5594
• fix: rancher desktop docker-platform should not report linux-docker by @rfay in #5593
• ci: Skip TestGetLocalHTTPResponse on Colima by @rfay in #5600
• fix: disable Xdebug for composer command, fixes #4219 by @stasadev in #5586
• fix: update outdated link for hostname, fixes #5604 [skip ci] by @stasadev in #5605
• fix: don't let people run ddev under rosetta, report no-bind-mounts behavior, fixes #5590 by @rfay in #5597
• fix: php8.3-xdebug and redis, memcached now available by @rfay in #5608
• fix: dont auto start host custom commands, fixes #2688 by @rfay in #5603
• build: bump actions/setup-python from 4.7.1 to 5.0.0 by @dependabot in #5617
• build: bump actions/setup-go from 4 to 5 by @dependabot in #5618
• ci: fix Python conflicts in Colima tests by @stasadev in #5614
• docs: fix invalid command reference, pgdump by @timkelty in #5616
• fix: return MTU 1440 for Gitpod, fixes #5611 by @stasadev in #5612
• fix: ensure help information respects --json-output flag, fixes #5567 by @GuySartorelli in #5572
• fix: do not fail on apt-get update for extra packages, for #5620 by @stasadev in #5623
• ci: enable all ddev-webserver tests for PHP 8.3, for #5238 by @stasadev in #5624
• feat: add detail about restore command to snapshot command output, fixes #5621 by @joachim-n in #5622
• feat: add toggle arg to xdebug command, fixes #3593 by @GuySartorelli in #5625
• build: bump images to v1.22.6 for release by @stasadev in #5626

New Contributors

• @timkelty made their first contribution in #5616
• @GuySartorelli made their first contribution in #5572

Full Changelog: v1.22.5...v1.22.6

v1.22.5: PHP 8.3.0 OrbStack, Upsun, Acquia provider

Installation

See the installation instructions for details, but it's easy:

• macOS: brew install ddev/ddev/ddev or just brew upgrade ddev.
• Traditional Windows: Use choco upgrade -y ddev, or download the ddev_windows_installer below.
• Linux or WSL2: Use apt install ddev or apt upgrade ddev see apt/yum installation or use the install_ddev.sh: curl -fsSL https://raw.githubusercontent.com/ddev/ddev/master/scripts/install_ddev.sh | bash
• And anywhere, you can just download the tarball or zipball, untar or unzip it, and place the executable in your $PATH where it belongs.
• Consider ddev delete images or ddev delete images --all after upgrading to free up disk space used by previous docker image versions. This does no harm.
• Consider ddev config --auto to update your projects to current configuration.

Highlights:

• PHP 8.3.0 is available, including most extensions, just missing memcached, redis, and xdebug
• Explicit support for OrbStack and Rancher Desktop Docker providers on macOS
• Upsun by Platformsh provider integration using ddev pull upsun.
• Rework Acquia provider integration, you can now use ddev pull acquia without editing the acquia.yaml file.
• You can configure any node version (including unsupported versions and minor versions) with ddev config --nodejs-version <version>, thanks to @hanoii
• A few DDEV users had problems with duplicate Docker networks, and that should be resolved here.
• Improved autocompletion, including custom commands

Behavior Changes:

• ddev composer create no longer tries to remove your files if the project directory is not empty, thanks to @hanoii
• There was a problem with environment variables propagating to php-fpm in PHP 8.3, preventing Drupal usage from working correctly; that's resolved.
• Rework Shopware setup and update it to 6.5 - now it's much easier.

Minor Notes:

• The mailpit version is updated to latest, thanks to @syssi

What's Changed

• build: update .gitpod.yml for v1.22.4 release [skip ci] by @stasadev in #5464
• fix: make project network external, fixes #5193 by @stasadev in #5305
• docs: add info about disk space checking on wsl2 by @rfay in #5467
• feat: install shell competions on HEAD by @hanoii in #5456
• fix: we shouldn't show the amplitude warning on every ddev command by @rfay in #5471
• fix: remove unnecessary use of fmt.Sprintf by @testwill in #5461
• build: bump docker-compose to v2.23.0 by @rfay in #5472
• build: always use the latest go and golangci-lint for gitpod [skip ci] by @stasadev in #5481
• build: bump github.com/docker/docker from 24.0.4+incompatible to 24.0.7+incompatible by @dependabot in #5479
• ci: gather debugging information about possible TestExtraPackages failure by @rfay in #5473
• docs: minor fix of env to use for amplitude debugging by @rfay in #5482
• ci: stop testing no-bind-mounts and use drupal10 by default by @rfay in #5480
• docs: specify ddev tap in upgrading instructions for macOS with brew by @bencroker in #5484
• fix: add correct mimetype for xsl and xslt, fixes #5457 by @apotek in #5458
• fix: implement limit on number of hosts per line in /etc/hosts because Safari has problems with long lines, fixes #2817 by @rfay in #4805
• fix: default file/uploads location for Silverstripe by @Firesphere in #5241
• docs: implement search priority setting using mkdocs-material by @rfay in #5500
• fix: partial revert of #5383 add -t flag back to mailpit sendmail command by @joelpittet in #5496
• docs: update custom commands example to show some of the possible annotations by @rfay in #5488
• docs: adds a dark theme compatible svgs, fixes #5492 by @bmartinez287 in #5501
• docs: adds a dark theme compatible svgs, fixes #5492 #5501 by @bmartinez287 in #5511
• feat: add TestComposerCreateCmd to push-pull-test-platforms, tests #5499 by @hanoii in #5516
• fix: allow editing for platform.yaml by @stasadev in #5515
• docs: allow uppercase letters on pr titles. by @bmartinez287 in #5514
• build: add monthly contributor report by @rfay in #5512
• fix: allow testcmd to run as make tarket on pull-push-test-platforms, follow up to #5516 by @hanoii in #5517
• build: use latest version of mailpit at image build time by @syssi in #5524
• fix: build new ddev-webserver to get fixed lagoon-sync, rework Acquia for #4760 by @rfay in #5519
• fix: ensure no duplicates for docker networks, fixes #5193 by @stasadev in #5508
• docs: use make test instead of make testpkg by @hanoii in #5528
• docs: remove the docs about obsolete drush-on-host feature by @rfay in #5530
• docs: PhpStorm CLI debug error "Can't find a source position. Server with name 'SITE_NAME.ddev.site' doesn't exist." by @RuZniki in #5531
• fix: internal project network with duplicate check, revert for #5305 by @stasadev in #5533
• docs: add instructions how to add colima to the macos login items by @rpkoller in #5538
• ci: revert colima to 0.5.6, use macos-13 by @rfay in #5540
• test: check for duplicate networks, for #5508 by @stasadev in #5541
• fix: add label for ddev-router, fixes #5542 by @stasadev in #5545
• docs: Update list of project types in comments for config.yaml, fixes #5544 by @ayacoo in #5546
• feat: implement ddev pull upsun provider integration, fixes #5446 by @stasadev in #5529
• feat: replace deb.nodesource.com with n, fixes #5509 by @hanoii in #5521
• ci: try Colima latest to fix serious docker failures by @rfay in #5549
• build: bump actions/github-script from 6 to 7 by @dependabot in #5551
• fix: revert "build: bump actions/github-script from 6 to 7" by @stasadev in #5552
• docs: Remove WSL2 step of installing from store by @rfay in #5553
• docs: add maintainer training resources, add testing and docs for OrbStack and Rancher Desktop, fixes #5113, fixes #4858 by @rfay in #5548
• fix: add project config validation when using args, fixes #5445 by @stasadev in #5452
• build: bump actions/github-script from 6 to 7 by @stasadev in #5554
• ci: fix buildkite runner problems with orbstack and rancher by @rfay in #5558
• docs: remove 'just' from several places to avoid triggering textlint by @rfay in #5556
• docs: add instructions for testing a PR by installing a downloaded binary in the $PATH by @gitressa in #5451
• docs: improve discussion of tarball to be imported by ddev import-files, fixes #5474 by @rfay in #5478
• fix: Add linux-docker platform for non-wsl2 docker-ce by @rfay in #5560
• fix: add config validation for --all flag, for #5452 by @stasadev in #5555
• feat: avoid having to remove files in ddev composer create #5493 by @hanoii in #5499
• docs: pacify linter on Zip vs ZIP by @rfay in #5562
• docs: improve steps for macos buildkite agent by @stasadev in #5561
• build: bump docker-compose to v2.23.3 by @stasadev in #5563
• build: install only binary from Upsun, for #5529 by @stasadev in #5564
• docs: fix indentation for Docker provider list by @stasadev in #5565
• build: bump images to v1.22.5 for pre-release by @stasadev in #5566
• fix: update shopware to 6.5, quickstart and defaults to 6.5+composer by @rfay in #5489
• refactor: order host, port, driver the same both places in Drupal 10 settings file by @gitressa in #5570
• docs: mention problems with shopware6 ddev composer create by @rfay in #5569
• ci: don't fail tests based on file removal failure by @rfay in #5571
• fix: php8.3 should allow environment variables to php-fpm by @rfay in https://github.com/ddev/ddev/...

v1.22.5-rc2

Installation/Upgrade

See the installation instructions for details, but it's easy:

• macOS: brew install ddev/ddev-edge/ddev or just brew upgrade ddev/ddev-edge/ddev (You may need a brew update for homebrew to find the new release.)
• Traditional Windows: Use choco upgrade -y --pre ddev to get this one, or download the ddev_windows_installer below.
• Linux or WSL2 (macOS works too) use the install_ddev.sh script: Download the script, make it executable, and run it with the version: ./install_ddev.sh <version> or or curl -LO https://raw.githubusercontent.com/ddev/ddev/master/scripts/install_ddev.sh && bash install_ddev.sh <version> - If you already had ddev installed otherwise, uninstall or unlink first. If you prefer to use a package, download the deb file from this release and install it.
• And anywhere, you can just download the tarball or zipball, untar or unzip it, and place the executable in your path where it belongs.
• Consider ddev delete images after upgrading to free up disk space used by previous docker image versions. This does no harm.

Highlights:

• PHP 8.3.0 is available, including most extensions, just missing memcached, redis, and xdebug
• Upsun by Platformsh provider integration using ddev pull upsun.
• Rework Acquia provider integration, you can now use ddev pull acquia without editing the acquia.yaml file.
• You can configure any node version (including unsupported versions and minor versions) with ddev config --nodejs-version <version>, thanks to @hanoii
• A few DDEV users had problems with duplicate Docker networks, and that should be resolved here.

Behavior Changes:

• ddev composer create no longer tries to remove your files if the project directory is not empty, thanks to @hanoii
• There was a problem with environment variables propagating to php-fpm in PHP 8.3, preventing Drupal usage from working correctly; that's resolved.
• Rework Shopware setup and update it to 6.5 - now it's much easier.

Minor Notes:

• The mailpit version is updated to latest, thanks to @syssi

What's Changed

• fix: update shopware to 6.5, quickstart and defaults to 6.5+composer by @rfay in #5489
• refactor: order host, port, driver the same both places in Drupal 10 settings file by @gitressa in #5570
• docs: mention problems with shopware6 ddev composer create by @rfay in #5569
• ci: don't fail tests based on file removal failure by @rfay in #5571
• fix: php8.3 should allow environment variables to php-fpm by @rfay in #5573
• build: update images to get get php8.3.0 and related new packages by @rfay in #5574

Full Changelog: v1.22.5-rc1...v1.22.5-rc2

v1.22.5-rc1

Installation/Upgrade

See the installation instructions for details, but it's easy:

• macOS: brew install ddev/ddev-edge/ddev or just brew upgrade ddev/ddev-edge/ddev (You may need a brew update for homebrew to find the new release.)
• Traditional Windows: Use choco upgrade -y --pre ddev to get this one, or download the ddev_windows_installer below.
• Linux or WSL2 (macOS works too) use the install_ddev.sh script: Download the script, make it executable, and run it with the version: ./install_ddev.sh <version> or or curl -LO https://raw.githubusercontent.com/ddev/ddev/master/scripts/install_ddev.sh && bash install_ddev.sh <version> - If you already had ddev installed otherwise, uninstall or unlink first. If you prefer to use a package, download the deb file from this release and install it.
• And anywhere, you can just download the tarball or zipball, untar or unzip it, and place the executable in your path where it belongs.
• Consider ddev delete images after upgrading to free up disk space used by previous docker image versions. This does no harm.

Highlights:

• Upsun by Platformsh provider integration using ddev pull upsun.
• Rework Acquia provider integration, you can now use ddev pull acquia without editing the acquia.yaml file.
• You can configure any node version (including unsupported versions and minor versions) with ddev config --nodejs-version <version>, thanks to @hanoii
• A few DDEV users had problems with duplicate Docker networks, and that should be resolved here.

Behavior Changes:

• ddev composer create no longer tries to remove your files if the project directory is not empty, thanks to @hanoii

Minor Notes:

• The mailpit version is updated to latest, thanks to @syssi

What's Changed

• fix: default file/uploads location for Silverstripe by @Firesphere in #5241
• docs: implement search priority setting using mkdocs-material by @rfay in #5500
• fix: partial revert of #5383 add -t flag back to mailpit sendmail command by @joelpittet in #5496
• docs: update custom commands example to show some of the possible annotations by @rfay in #5488
• docs: adds a dark theme compatible svgs, fixes #5492 by @bmartinez287 in #5501
• docs: adds a dark theme compatible svgs, fixes #5492 #5501 by @bmartinez287 in #5511
• feat: add TestComposerCreateCmd to push-pull-test-platforms, tests #5499 by @hanoii in #5516
• fix: allow editing for platform.yaml by @stasadev in #5515
• docs: allow uppercase letters on pr titles. by @bmartinez287 in #5514
• build: add monthly contributor report by @rfay in #5512
• fix: allow testcmd to run as make tarket on pull-push-test-platforms, follow up to #5516 by @hanoii in #5517
• build: use latest version of mailpit at image build time by @syssi in #5524
• fix: build new ddev-webserver to get fixed lagoon-sync, rework Acquia for #4760 by @rfay in #5519
• fix: ensure no duplicates for docker networks, fixes #5193 by @stasadev in #5508
• docs: use make test instead of make testpkg by @hanoii in #5528
• docs: remove the docs about obsolete drush-on-host feature by @rfay in #5530
• docs: PhpStorm CLI debug error "Can't find a source position. Server with name 'SITE_NAME.ddev.site' doesn't exist." by @RuZniki in #5531
• fix: internal project network with duplicate check, revert for #5305 by @stasadev in #5533
• docs: add instructions how to add colima to the macos login items by @rpkoller in #5538
• ci: revert colima to 0.5.6, use macos-13 by @rfay in #5540
• test: check for duplicate networks, for #5508 by @stasadev in #5541
• fix: add label for ddev-router, fixes #5542 by @stasadev in #5545
• docs: Update list of project types in comments for config.yaml, fixes #5544 by @ayacoo in #5546
• feat: implement ddev pull upsun provider integration, fixes #5446 by @stasadev in #5529
• feat: replace deb.nodesource.com with n, fixes #5509 by @hanoii in #5521
• ci: try Colima latest to fix serious docker failures by @rfay in #5549
• build: bump actions/github-script from 6 to 7 by @dependabot in #5551
• fix: revert "build: bump actions/github-script from 6 to 7" by @stasadev in #5552
• docs: Remove WSL2 step of installing from store by @rfay in #5553
• docs: add maintainer training resources, add testing and docs for OrbStack and Rancher Desktop, fixes #5113, fixes #4858 by @rfay in #5548
• fix: add project config validation when using args, fixes #5445 by @stasadev in #5452
• build: bump actions/github-script from 6 to 7 by @stasadev in #5554
• ci: fix buildkite runner problems with orbstack and rancher by @rfay in #5558
• docs: remove 'just' from several places to avoid triggering textlint by @rfay in #5556
• docs: add instructions for testing a PR by installing a downloaded binary in the $PATH by @gitressa in #5451
• docs: improve discussion of tarball to be imported by ddev import-files, fixes #5474 by @rfay in #5478
• fix: Add linux-docker platform for non-wsl2 docker-ce by @rfay in #5560
• fix: add config validation for --all flag, for #5452 by @stasadev in #5555
• feat: avoid having to remove files in ddev composer create #5493 by @hanoii in #5499
• docs: pacify linter on Zip vs ZIP by @rfay in #5562
• docs: improve steps for macos buildkite agent by @stasadev in #5561
• build: bump docker-compose to v2.23.3 by @stasadev in #5563
• build: install only binary from Upsun, for #5529 by @stasadev in #5564
• docs: fix indentation for Docker provider list by @stasadev in #5565
• build: bump images to v1.22.5 for pre-release by @stasadev in #5566

New Contributors

• @syssi made their first contribution in #5524
• @RuZniki made their first contribution in #5531

Full Changelog: v1.22.5-alpha1...v1.22.5-rc1