Installation/Upgrade

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

• Please stop all projects first, this does no harm: ddev poweroff
• If you have custom configuration, especially pinned image specifications in your .ddev/config.yaml, please remove it for now.
• 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.
• 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 Features of v1.16.0-alpha8

• PHP8.0-rc1 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 !)

From earlier alpha releases

• 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.0.0-RC2 and ddev start. Any version specification available from composer can be used. ddev config --composer-version=latest will get the most recent stable build, currently composer 1.
• 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

• 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-alpha7

8de02b7 mysql_version should override mariadb_version if it is set, fixes #2571 (#2581)
467255d Fix missing output of exec-host and make it interactive (#2579)
0c2a175 PHP8/xdebug v3 configuration and tests, fixes #2566 (#2577)
8db0b9a ddev auth ssh shouldn't work if ddev-ssh-agent opted out, fixes #2573 (#2576)
2817875 Bump db version to pinned 8.0.21 (#2575)
dc59161 Shopware6 support for ddev, make hostnames and URLs lowercase, fixes #1988 (#2551)
1828acd Fix config sync directory for Drupal 8 websites that are using a custom sync directory (#2558)
ce08cd0 Pin mysql 8 to 8.0.21 (#2570)
9476b61 Provide DRUSH_ALLOW_XDEBUG=1 to allow drush launcher xdebug usage (#2567)