Installation/Upgrade

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

• If you edited your config.yaml with webimage pointing to an older webimage to solve the Xdebug problem, please remove that webimage pin.
• If you are on Windows and use nfs_mount_enabled, please stop nfsd first: sudo nssm stop nfsd. After installation you'll want to sudo nssm start nfsd again.
• 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: brew install ddev or ddev poweroff && brew upgrade ddev ). (You may need a brew update for homebrew to find the new release. If you don't already have the ddev tap, brew tap drud/ddev first)
• Windows: Use ddev poweroff && choco upgrade ddev, 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.13.0

• Magento 1 and Magento 2 Support, thanks @paulvandermeijs !
• PHP 7.3 becomes the default PHP version
• Behavior of ddev import-db changes: By default it will (again) empty the database before importing. Use the --no-drop argument if you want to add your import to an existing database.
• ddev import-db and ddev export-db now take a --target-db argument if you want to import to/create a database in addition to the default database named "db".
• import-db and export-db now accept the project name name as an argument.
• If you have a complex project and do not want ddev to manage your CMS settings files, you can now use disable_settings_management: true in your config.yaml (or ddev config --disable-settings-management) People used to have to use the "php" project type to accomplish this, but this is probably a better approach.
• Pantheon integration has been completely redone. 1) The "auth" command is now ddev auth pantheon instead of ddev auth-pantheon. Everything else works the same, but you'll need to re-authenticate with pantheon, and use ddev config pantheon to set up.

Smaller changes

• $IS_DDEV_PROJECT can be used to determine if ddev is the running environment. Generated settings files try to respect this as well. This is used in the generated settings files to try to prevent ddev settings from interfering with any other configuration.
• Removed deprecated webcache feature.
• Update Drush version in web container from 8.3.1 to 8.3.2
• .ddev/web-build/Dockerfile can now use .ddev/web-build as context for adding files, etc.
• utf8mb4 is now the default collation for database connections
• PHPMyAdmin upgraded to version 5
• On Drupal 8, ddev configures drush.yml in <projectroot>/drush/drush.yml instead of the previous <docroot>/sites/all/drush/drush.yml. However, this version does not try to remove any sites/all/drush that you may still have, so it's good to remove that if you have ddev-generated files there. (Note that if you don't want ddev creating this file - or settings management in general - then use disable_settings_management: true.)

Caveats

• If you use drush on the host to interact with your project, please export IS_DDEV_PROJECT=true in your environment. The settings files have no way to know that you want to use ddev settings if you don't do this.
• The auth command for Pantheon has changed, use ddev auth pantheon <key>.
• If you use or set $config_directories[CONFIG_SYNC_DIRECTORY] or the Drupal 8.8+ style $settings['config_sync_directory'] in your Drupal 8 settings.php, please check to see that your modifications are done below the include of settings.ddev.php, so they can override the default applied there.

Commits since v1.12.0

9f42453 Bump containers to v1.13.0 (#2069)
399cdce generate_artifacts needs to include phpmyadmin image in image tarball [skip ci][ci skip] (#2068)
5f1b7d7 Bump container versions to v1.13.0-rc2 (#2066)
de89fd2 subdirectories of commands/* should not show up as custom commands (#2060)
be0f12e Give more info on docker-compose.yaml error (#2052)
d0ceef1 Use proper IS_DDEV_PROJECT, not IS_DRUSH_PROJECT (#2061)
e4f816a Remove debug code about provider.Validate return value (#2062)
93ca065 Improve docs per notes in v1.13.0-rc1 testing [skip ci][ci skip] (#2063)
3483441 Actually select database when --target-db is provided to export-db (#2058)
48cf885 Misc docs improvement: Mostly readthedocs/mkdocs headings, fixes #1932 (#2053)
08720f9 Improve import-db/export-db with --target-db and --no-drop flags, fixes #1961, fixes #1652 (#2037)
4f46f7f Simplify CircleCI build, less configuration, remove macOS build (#2051)
fa59ea0 Bump containers to v1.13.0-rc1 (and phpmyadmin to 5) (#2050)
4975476 Prevent inappropriate rewrite of global_config.yaml, fixes #1882, fixes #2014 (#2040)
0e0ccc2 Custom container build cleanup, fixes #2021, fixes #1855 (#2042)
27d0046 Add disable_settings_management as config option, fixes #2024, fixes #1806 (#2036)
7ee70ec Bump backdrop extensions to 1.2.0 (#2034)
ef396f3 Improve settings.ddev.php handling of config_sync_directory (#2039)
de100c7 Always add restore-snapshot command (#2032)
14d43ba Add gnupg2 to container build to fix xtrabackup fail (#2047)
d2785b4 Bump web tag for xdebug 2.9.1 fixes #1996 (#2035)
ad90531 Support Magento v1 and v2, fixes #1011 (#1802)
9f43569 Add 'IS_DDEV_PROJECT' to environment, require it for drush-on-host (#1856)
b5bd89e Move drush.yml into /drush from sites/all/drush (#2025)
0ef68f5 Solr docs - fix typo with incorrect script name (#2028) [skip ci][ci skip]
4698d8c Simplify TYPO3 composer example (#2026)
2cd04cf Create .ddev/.gitignore on ddev start and config (for teams), fixes #1997 (#1998)
afdab4f Subdirectories in commands dirs should not show up as commands (#2022)
11254bb Notarize ddev for macOS Catalina (#2015)
93cb8f8 Add timeout to docker startup in macos circleci (#2019)
a79b8f5 Additional location to define sync directory in settings.ddev.php (#1994)
3cbe60e Update markdown for all docs (#2013)
b29c88f Remove deprecated webcache feature (#2017)
c5c8730 Unlink python2 since it can't be used any more (#2016)
1a7e553 Improve database_types docs (#1995)
a489da7 Skip composer --no-install on Windows NFS (tests only) (#2012)
f799bf1 Fix enable_xdebug / disable_xdebug not fully working for apache-cgi (#1981)
ee9bfb1 Use sudo to copy dotfiles into user dir on start (#2004)
112f288 Use unzip -o (mostly in testing) (#2005)
3391918 Add utf8mb4 client collation to my.cnf in containers (#2006)
4d7cf50 Rework pantheon integration to use terminus inside web container, fixes #1731, fixes #1232 (#1827)
d9b3727 Use recent phpmyadmin version (4.9) and stop using drud variant (#2010)
f4fee46 Use PHP7.3 as default PHP version (#1982)
eda7c74 [TASK] Remove empty trailing lines from PHP files and templates (#2007)
ebfcb9c Debian buster is now the mainline distribution, use it instead of stretch, fixes #2009 (#1983)
28e0b50 Remove file_scan_ignore_directories from ddev Drupal settings (#1976)
5e2027d Update Drush version from 8.3.1 to 8.3.2, fixes #1999 (#2000)
cd9093c Add .markdownlintrc defining markdown, especially for readthedocs (#2003)
4123aed Header in drush.yml has bogus copy/paste comment (#1977)
29c15e8 better example on drupal7/8 config (#1986)