ddev/ddev v1.21.2 on GitHub

Highlights

PHP8.2 support although not all extensions are ready yet. (php8.2-xdebug is not yet supported)
Craft CMS: Explicit support of Craft CMS and the ddev craft command, thanks to @khalwat and @bencroker!
TYPO3 v12 support: The settings files have changed in TYPO3 v12; thanks to @gilbertsoft this release works with TYPO3 v12.
Mutagen update: leave mutagen sync paused instead of deleting it; better support of in-container permissions on traditional Windows, new ddev mutagen logs command. Mutagen sync time on traditional Windows seems to be significantly improved over previous versions.
DDEV Fig spec generation, thanks to @khalwat!
Global project_tld: You can now set the default top-level domain for all projects with the global project_tld in ~/.ddev/global_config.yaml or with ddev config global --project-tld=somedomain.org. Thanks @bbrala!
Under the hood: Significant mutagen changes, with a new version and an isolated mutagen daemon that is only used by DDEV. You can remove your ~/.mutagen directory if you only use mutagen for DDEV, but if you do use mutagen for other things, you no longer have to worry about version conflicts or anything else.

Installation/Upgrade

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

macOS: brew install drud/ddev/ddev or just brew upgrade drud/ddev/ddev ). (You may need a brew update for homebrew to find the new release.).
Traditional Windows: Use choco upgrade -y ddev, or download the ddev_windows_installer below.
Linux or WSL2 (macOS works too): Use apt install ddev or apt upgrade ddev see apt/yum installation or use the install_ddev.sh: curl -fsSL https://raw.githubusercontent.com/drud/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.

Minor Changes

Improve yarn and npm project cache management.
ddev mutagen logs command for debugging.
You no longer need to put version: 3.6 (or any version:) in docker-compose.*.yaml files or ddev-get add-ons.
Improved detection of existing database type, solves problems with upgrading older versions of DDEV, and fixes postgres:9 detection.
If composer_root is set, the vendor/bin is added to the $PATH so things like ddev drush will work even in places where the composer_root is not in the project root.
Testing to see if the internet is reachable is done far less often, so you probably won’t ever see a timeout complaint from it again. This should make the DDEV Integration Plugin for PhpStorm have less timeouts.
ddev debug migrate-database added, for example ddev debug migrate-database mysql:5.7 to migrate to mysql:5.7. It exports the database and then reimports with the new type. Works only with MariaDB and MySQL and normally won’t work with mysql:8.0 as the source type.
ddev debug get-volume-db-version will inspect the database type that is currently in use. You don’t even have to start the project to run it.

THANKS

As always there have been so very many wonderful contributions from the community, but I wanted to call out just a couple here:

Jacob Howard, @xenoscopic, took a whole morning to chat in person and talk about a variety of things, including DDEV’s mutagen integration and how it could be improved. Those suggestions resulted in sigificant under-the-hood mutagen work in this release.
@hanoii took the time to thoroughly research yarn and npm caching issues with various versions, recreated problems, suggested solutions, and then did a thorough test.
@rpkoller installed the HEAD version every time a new commit went in, and carefully studied and tested the Mutagen (and other) changes. It made a huge difference.
@mattstein gave his very lifeblood (or brain blood?) to do a massive update to the docs, with consistency and purpose.
The new Craft CMS explicit project type is thanks to @khalwat and @bencroker who took it on out of the blue and pushed it through. Thanks!
@gilbertsoft noticed that newly minted TYPO3 v12 wasn’t working with DDEV and rolled a PR right away.

What's Changed

Use --web-environment-add instead of --web-environment in blackfire error by @Berdir in #4130
Fix PhpStorm integration instructions, fixes #4083 by @rfay in #4128
[docs] Give example of nginx snippet and remove statement that it will be removed by @rfay in #4136
[docs] Add redirect http->https info to casual webhosting by @rfay in #4138
Do IsInternetActive() less often, and do it more efficiently, fixes #4131 by @rfay in #4134
[TASK] Add missing quote in test_ddev.sh by @georgringer in #4140
[DOCS] Add hint to hooks by @peterkraume in #4139
Improve apt packages and docs, fixes #4112, fixes #4113, fixes #4125 by @rfay in #4133
Recognize older and all database types from volume, fixes #4129 by @rfay in #4132
ddev list: Truncate app list table text to avoid wrapping by @cmuench in #4137
test: use T.Setenv to set env vars in tests by @Juneezee in #4126
On upgrade ,remove old provider/platform.yaml.example [skip ci] by @rfay in #4141
Don't show warning when removing platform.yaml.example [skip ci] by @rfay in #4145
Set version constraint for docker-compose to current, fixes #4135 by @rfay in #4142
Bump required docker-compose to 2.10.1 by @rfay in #4143
[ tests only] Solve colima ContainerWait failure by @rfay in #4144
[docs] add to FAQ how to install specific version with apt by @rfay in #4148
Make sure vendor/bin is in PATH even if composer_root is different, fixes #4060 by @rfay in #4147
Mutagen rework to use volume label and session label by @rfay in #4109
Remove requirement of docker-compose version 3.6 in docker-compose.*.yaml, for #3214 by @rfay in #4151
Mutagen followup: Make sure mutagen sync sessions are terminated by @rfay in #4153
[docs] Improve DDEV update/upgrade instructions by @linawolf in #4149
[docs] Mutagen debugging followup by @rfay in #4154
[docs] Make sure to disable Docker Desktop integration before installing wsl2 docker-ce by @rfay in #4155
[docs] Mention need to configure docker-compose for PhpStorm by @rfay in #4157
[docs] Mention twig debugging in Drupal CMS specific docs by @rfay in #4158
Mutagen: Unmarshall only stdout, not combined output by @rfay in #4156
Fix up test_ddev.sh [skip ci] by @rfay in #4164
[docs] Add note about checking unused space when importing DBs [skip ci] by @tyler36 in #4166
Don't flush mutagen if project not running, fixes #4162, fixes #4163 by @rfay in #4165
[docs] Use more initial colima disk allocation by @rfay in #4171
Add description to nfpms, fixes #4168 by @rfay in #4174
Ask people about upload_dir when mutagen is set by @rfay in #4173
Try docker-compose 2.10.2 to see if it works by @rfay in #4167
[output] Fix typo/needs period at end of output string in root.go by @rpkoller in #4172
[docs] Be clear about MySQL/MariaDB config enhancement by @rfay in #4177
[Homebrew] Fix zsh completion file name by @voronkovich in #4179
[Docs] Remove extra back-tick from snippets (and trailing whitespace). by @henokmikre in #4183
Add an initial code of conduct #4159 by @deviantintegral in #4186
Improve issue templates by @mattstein in #4185
Updated link to Magento 1/OpenMage sample data by @sreichel in #4196
Allow .ddev/.downloads in web container for pull providers, fixes #4193 by @joelpittet in #4194
Adds Craft CMS project type, docs, and tests closes #3594 by @khalwat in #4176
[tests only] Make TestPantheonPull do commits monthly by @rfay in #4201
[docs] Improve building/testing section by @rfay in #4192
Add Lullabot as a sponsor to the README by @deviantintegral in #4205
[docs] Add links to template usage helps by @rfay in #4204
Bump rojopolis/spellcheck-github-actions from 0.26.0 to 0.27.0 by @dependabot in #4203
Add craft command transition by @bencroker in #4199
Remove obsolete certs from certfiles by @rfay in #4210
[docs] Add Craft CMS logo ($100 sponsor) by @rfay in #4212
Bump mutagen (v0.16.0-beta1) for non-utf8 filenames and set it to use windows 777 permissions by @rfay in #4206
[docs] Add undpaul and 1xinternet logos as sponsors by @rfay in #4217
Support PHP 8.2 in DDEV by @rfay in #4222
[tests only] Add brew to path to fix missing brew by @rfay in #4224
[output] improve custom config output in config.go by @rpkoller in #4202
feat: add DDEV Fig spec generation by @khalwat in #4216
Implement ddev mutagen logs command, fixes #4161 by @rfay in #4226
Align composer_version docs with Composer version channels, fixes #4227, for #3812 by @eliashaeussler in #4228
Clean up messaging on new ddev version by @rfay in #4232
ddev mutagen logs should just restart daemon, not sync by @rfay in #4231
[docs] Improve gitpod PR checking docs to say to delete the sample project by @hanoii in #4238
[docs] Explain how to do docs PR in browser by @rfay in #4237
Fix test_ddev.sh so it doesn't continue if unable to create test dir [skip ci] by @rfay in #4239
Don't stop project on start failure by @rfay in #4235
[docs] Expanded the Laravel quickstart with instructions on how to run Vite by @Ellarddekoeijer in #4236
ddev debug test should be run in a project directory [skip ci] by @rfay in #4249
Bump styfle/cancel-workflow-action from 0.10.0 to 0.10.1 by @dependabot in #4251
Fix postgres:9 detection of existing project, fixes #4229 by @rfay in #4241
Rework yarn and npm cache dirs, fixes #4215 by @rfay in #4234
[docs] Formatting and proper noun tune-up by @mattstein in #4200
[docs] Fix linter fragment complaint by @rfay in #4260
[docs] Update example service list by @mattstein in #4263
Bump images to v1.21.2 for upcoming release by @rfay in #4261
[docs] Add spell check instructions by @mattstein in #4264
[docs] Improve ordering of Colima installation by @filimoreira in #4255
Implementation of global project-tld config option by @bbrala in #4218
Use proper post-start hook label everywhere by @hanoii in #4265
[docs] Remove merge remnants by @mattstein in #4269
[docs] Update version history [skip ci] by @rfay in #4270
[docs] Fix incorrect statement about where homebrew can be used by @rfay in #4272
[docs] auto-install recommended packages by @shaal in #4275
Add Symfony Mailer config for Mailhog in Drupal 9 settings #2706 by @luenemam in #4214
[docs] Add writing style guide by @mattstein in #4271
[docs] fix command for installing Ubuntu 20.04 on WSL2 by @shaal in #4274
Offer ddev restart option for failure to remove volume by @rfay in #4266
Add support for TYPO3 v12 by @gilbertsoft in #4268
Bump mutagen to 0.16.0-rc1 by @rfay in #4277

New Contributors

@Berdir made their first contribution in #4130
@georgringer made their first contribution in #4140
@Juneezee made their first contribution in #4126
@linawolf made their first contribution in #4149
@rpkoller made their first contribution in #4172
@voronkovich made their first contribution in #4179
@henokmikre made their first contribution in #4183
@mattstein made their first contribution in #4185
@sreichel made their first contribution in #4196
@khalwat made their first contribution in #4176
@eliashaeussler made their first contribution in #4228
@Ellarddekoeijer made their first contribution in #4236
@filimoreira made their first contribution in #4255
@bbrala made their first contribution in #4218
@luenemam made their first contribution in #4214

Full Changelog: v1.21.1...v1.21.2