Installation/Upgrade

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

• Please stop all projects first, this does no harm: ddev poweroff
• macOS Linux, and WSL2 Homebrew (ddev-edge channel only): brew install drud/ddev-edge/ddev or just brew upgrade drud/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 and macOS with the install_ddev.sh script: Download the script, make it executable, and run it with the version: ./install_ddev.sh <version>
• 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.

Key changes in v1.18.0-rc1

• The headline remains experimental Mutagen support, offering vastly faster webserver performance. See the docs - it's really cool. Please make sure no competing mutagen instances are running (use killall mutagen) and thenddev config --mutagen-enabled && ddev start. See docs and article for performance details. This great feature was sponsored by Tag1 Consulting.
  • Much better status reporting on ddev start, so you don't have to wonder what's happening so much
  • New ddev mutagen reset , ddev mutagen sync, ddev mutagen monitor subcommands
  • Docs updates
  • Several bugs and usability improvements
• Massive redesign of ddev describe and ddev list, with optional global table styles for each.
• PHP8.1beta3 is included
• These releases solve an obscure problem inside the web container that only happens on Mac M1 with some clients and some https servers that results in a Segmentation Error.
• xhprof integration now includes memory usage

Minor changes

• It is now possible to omit_containers[ddev-router] for situations where another reverse proxy is provided (like gitpod)
• ddev logs can now take a project-name argument
• Various bugfixes
• Improved interoperability with PhpStorm for running phpunit tests and composer integration.
• PHP_IDE_CONFIG is now set everywhere it needs to be, and not set in the context of php-fpm. Improves command-line and other interoperability.

Caveats

• docker-compose v1.25+ is now required (it was v1.21+, which was native on Debian 10 Buster, but that one didn't fully work)

Commits since v1.18.0-alpha4

5775ebb Add project-name arg to ddev logs, fixes #3203 (#3206)
d2407e8 Bump to latest upstream (ddev-images) php image. Adds PHP 8.1 and php8.0-uploadprogress (#3198)
5237b78 Allow global omit_containers["ddev-router"], add project config to bind_all_interfaces, fixes #3028, fixes #3184 (#3191)
9125552 Minor test cleanups, ignore some conflicts with mutagen on windows (#3204)
005d935 For numeric group names, also try adding user with group id, fixes #3187, fixes #3199 (#3192)
20bd619 Don't use a full path for source of bind mount, for #3130 (PhpStorm interoperability) (#3194)
a326e74 Bump mutagen version to 0.12.0-beta5 (#3201)
5a29850 Force github actions to use actual merge commit in pr build (#3202)
1c06422 Mutagen followups for rc1, fixes #3190 (#3197)
5e5affc Partial updates (volume naming) from docker-compose v2 PR (#3193)
e7ea48a Add vscode help link for launch.json (#3180)
ffa62df Update test_ddev.sh to fix typo on name in comments (#3186) [skip ci][ci skip]
e2bd82d Spiff up TestDdevStartUnmanagedSettings, etc, fix SEGV panic (#3183)
8f6b367 [tests only] Mute some tests on mac M1 to avoid random EOF/connection reset by peer problems (#3182)
832c7a5 Don't write version info into config.yaml (#3181)
69dccdb Mutagen followup tweaks and docs (#3176)
51acbf8 Allow customizing xhprof_prepend.php, fixes #3168 (#3170)
dc202de Debian 11 Bullseye released, nginx packages available, go back to nginx 1.20, fixes #3128 (#3178)
0d81f68 [Tests only] Skip TestGetLocalHTTPResponse on mac m1 - fails always (#3177)
59ff9d6 Remove embargo on TestExtraPackages (#3175)
29a86df [docs] Update pantheon to emphasize that the pantheon.yaml is in project dir [skip ci][ci skip]
8c7e4f4 Attempt to get more info about Windows failures in TestCmdMutagen (#3171)
782c0cc Force restart if mutagen volume did not get mounted (#3167)
a859fc6 [tests only] Simplify and speed up TestAcquiaPush (#3173)
5fb514e Improve mutagen startup status reporting (#3172)
7dede54 Use posix-raw as default symlink mode on macOS in mutagen.yml (#3150)
a5eb4ab Use working_dir in generated compose instead of always overriding, fixes #3158 (#3160)
65b8151 Blackfire packages are currently broken, embargo TestExtraPackages, force image removal (#3169)
f754a0b Use container ID for beta in sync session, fixes #3161 (#3162)
1ccfa37 Fix whitespace issue in troubleshooting.md [skip ci][ci skip]
1634225 Remove PHP_IDE_CONFIG in php-fpm instead of trying to add it elsewhere, replaces #3143, fixes #2998, fixes #3106 (#3149)
2346ace Add deleting docker images to troubleshooting doc [skip ci][ci skip]
2f9e963 Encourage use of expose instead of ports in docker-compose.*.yaml (#3151)
2004145 Allow use with docker-compose v2 when DDEV_ALLOW_COMPOSE_V2 is true (#3157)
dc44131 Check available space after we've already downloaded webimage (#3165)
ad21835 TestNFSMount fails because of NFS failure on windows, make it more resilient (#3166)
2f0ca90 Mutagen finish work for alpha5 (#3155)
e1c4693 Include memory consumption by default in xhprof output. (#3154)