Installation/Upgrade

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

• Please stop all projects first, this does no harm: ddev poweroff
• macOS Homebrew and Linux Linuxbrew (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.)
• 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.

Key changes in v1.16.0-rc1

• Default php8 is php8-rc3
• Default composer is composer 1.10.17 (use ddev config composer-version=2 to use composer 2)
• nodejs is upgraded to 14.x
• gulp-cli is added to the web image

From earlier edge releases

• Composer 2 support: You can now use ddev config --composer-version=1 or ddev config --composer-version=2 to just get the latest composer for v1 or v2. composer_version in .ddev/config.yaml takes "2" or "2" or an explicit version as well. Composer 1 remains the default version in ddev.
• Hardened ddev-webserver image for casual webhosting. See docs.
• PHP8.0-rc3 with xdebug 3. Note that xdebug 3 has new and incompatible configuration options, which won't matter to most ddev users as the defaults provided do the job
• Shopware 6 support, see Shopware 6 Quickstart
• hook exec-host output is now shown in real time (it used to be completely missing) (Thanks @gilbertsoft !)
• composer version can now be specified in config.yaml or with ddev config --composer-version. For example, to start using composer 2 today, ddev config --composer-version=2 and ddev start. Any version specification available from composer can also be used.
• PHP8.0-RC1 is included, ddev config --php-version=8.0. A few packages are not yet in the upstream repositories
• Solved a problem that affects Windows Docker Desktop 2.4.0.0 users only, and only those that use the near-deprecated Hyper-V back-end (the future of Docker Desktop for Windows is the WSL2 backend). ddev auth ssh did not work for those users, see #2539
• Experimental support for arm64 architectures (WSL2 and Linux only for now). THANKS @dennisameling! You can install on your linux/arm64 (or Windows machine running WSL2) with curl -LO https://raw.githubusercontent.com/drud/ddev/master/scripts/install_ddev.sh && bash install_ddev.sh v1.16.0-alpha5. Although this works great with Windows and WSL2 and also on Linux arm64, there is no support yet for the Windows installer and ARM64 machines. Support for macOS arm64 machines is planned when we get hardware this fall. Support for arm64 is not yet provided in AUR.
• The ddev tableplus command is now available alongside ddev sequelpro and ddev sequelace if you are on macOS and have one of those applications installed. Thanks @bobbygryzynger!
• The install_ddev.sh script now accepts an optional argument to allow specifying a particular ddev version.
• Bug fix for starting a project when port 80 is occupied (Thanks @chellman !)
• Better help for custom command flags (Thanks @gilbertsoft !)
• additional_hostnames can now be wildcarded.
• ddev-ssh-auth and router-compose docker-compose configurations can now be overridden
• Experimental usability as a webserver on the internet, including experimental Lets Encrypt support, see docs
• Experimental container auto-restart support
• Significantly improved performance on many ddev commands. ddev start may be twice as fast. ddev list is way faster, etc.
• TLS 1 and 1.1 disabled, TLS 1.3 enabled
• Project-specific and OS-specific commands
• Allow multiple directives including OSType and ProjectType in custom command so custom commands only show up in correct context.
• New ddev sequelace, ddev typo3, ddev typo3cms, ddev drush, ddev artisan, ddev magento, ddev wp commands
• Allow processing of PDF files with ImageMagick
• Remove drupal console from web image
• Improve docroot detection
• apache-cgi support has been removed after having been deprecated in v1.15
• Experimental custom TLS certificate support

Smaller changes

• Less intrusive internet detection, more docs on name resolution and its consequences.
• ddev auth ssh loads all keys found in ~/.ssh or in the directory specified with -d, not just the default keys like id_rsa
• ddev composer create and ddev delete images accept -y or --yes flags to skip the confirmation prompt
• Bug fixed which was introduced in v1.15.0-alpha7: If only mysql_version is set in config.yaml, ddev start will still work.
• docker images specified in omit_containers will not be pulled during ddev start, thanks @NBZ4live !
• ddev auth ssh will refuse to work if ddev-ssh-agent is an omitted container
• mysql 8.0 unpinned and updated to 8.0.21 (and then pinned again because of xtrabackup bug)
• Drupal 8 now defaults to use mariadb 10.3
• If omit_containers[] is used, containers listed will not be pulled during ddev start
• mysql_version and mariadb_version always show in .ddev/config.yaml; if empty, they get the default.
• The default nginx config no longer provides an "expires" header for css/js, so front-end developers don't have to constantly refresh browser.
• DRUSH_OPTIONS_URI is not set in the web container when disable_settings_management: true
• Standard Drupal/Backdrop settings files are used for generating settings files if none exists.
• Your entire home directory no longer has to be shared with docker, just the project directory (#2398)

Caveats

• Support for docker toolbox on Windows has been removed.
• Support for apache-cgi has been removed

Commits since v1.16.0-alpha9

8c7b96f Bump to latest images (#2611)
a4d7a76 Ongoing docs tweaks leading to v1.16.0 release (#2595)
3cc5a28 Add --yes -y flags to composer create and delete images, fixes #2387 (#2609)
5ad28c8 Try twice to get composer; many test failures (#2610)
d3b4a58 Magento2 Quickstart improvements, fixes #2600, fixes #2602 (#2603)
3153ed7 Make sure env vars are added to ssh-agent start and all keys are loaded, fixes #2597, fixes #2608 (#2606)
41cf849 Add docs and longer timeout for restore-snapshot and start, fixes #1477, fixes #2542 (#2598)
096f477 Simplify 'no internet connection' complaints, add to docs, fixes #2578, for #2533, for #2409 (#2605)
1e721f7 [docs] Add more info about DNS rebinding to FAQ (#2590)