Most of what you want to know is in the v1.17.0 release notes so please check there... Make sure you read the Caveats.

Installation/Upgrade

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

• macOS Homebrew and Linux Linuxbrew: brew install drud/ddev/ddev or brew upgrade drud/ddev/ddev ). (You may need a brew update for homebrew to find the new release.). This works on Apple Silicon Homebrew as well.
• Windows: Use choco upgrade -y 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: ./install_ddev.sh or curl -LO https://raw.githubusercontent.com/drud/ddev/master/scripts/install_ddev.sh && bash install_ddev.sh
• 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.
• In the past, a ddev poweroff was required; now ddev itself detects that you have a new version and asks for permission to do a poweroff.

Key changes for v1.17.3

This release has a number of minor upgrades:

• Please see the v1.17.0 release notes of course.
• Update default composer 2 in web container and ddev composer to 2.1.0
• Update wp-cli to v2.5.0 (first new release in a long time)
• Allow globally disabling http/2 support in ddev-router (ddev config global --disable-http2)
• Minor increases of webserver buffer sizes in ddev-router and ddev-webserver to help with huge cookie payloads.
• Upgrade to Blackfire agent v2 in web container
• Quite a lot of upgrades to infrastructure and cost reduction work, moving tests to GitHub Actions, etc.

Caveats

• Please see the Caveats in v1.17.0 release notes.

Commits since v1.17.2

2b1e70cf Update docker images for upcoming ddev v1.17.3 (#3035)
709ad8ae Increase ddev-router nginx large_client_header_buffers value for large cookie payload (#3033)
1db65a69 Increase ddev-webserver apache/nginx limit request field size for large cookie payloads (#3034)
74ae7f8b Make TestPoweroffOnNewVersion work on Windows, fixes #2979 (#3031)
ecd521d1 gitpod "prebuild" is deprecated, so switch to using init (#3032) [skip ci][ci skip]
f5e9a974 Remove Jessie keys so we can properly test for expiring keys, fixes #3004 (#3030)
40f9dbb0 Check ENV variable first before doing a FS stat in settings.ddev.php (#3017)
10cc42e8 Keep github template helper text visible only to the issue author (#3029) [skip ci][ci skip]
0f016094 Windows buildkite often has first-time trouble with DNS lookups (#3016)
772e26dd Stop reporting anything but start to segment (#3020)
8b58eb19 Allow globally disabling http/2 support in ddev-router (#3011)
4961432a Need to unsign binary before signing it (#3018)
43b81fe9 Make sure to notarize both macos binaries (#3015)
266ad75c Don't try to build chocolatey on interim revisions (#3012)
7a20a436 Move release builds to GitHub actions, sign with new Windows cert (#3003)
a2ec6668 Reduce how much circleci gets used (#3010)
e14d7afb Replace archived golint with revive and update errors (#3007)
773d1f69 Temporarily defer apt key expiration test on mysql 5.5/5.6/8.0, for #3004 (#3006)
a37e279e Docs: Fix mistaken reference to defaulting to mariadb 10.2 [skip ci][ci skip]
405c5c52 Make windows_install build on Windows (#2994)
dd7177fe Minor test fixup of TestDdevRestoreSnapshot (#2991)
e7bcc888 Fix broken markup that showed ddev-solr instead of ddev-projectname-solr [skip ci][ci skip]
281070cd Upgrade to Blackfire agent v2 in web container (#2970)
7f965ea2 Kill off ddev-router if it's not running, fixes #2981 (#2985)
88a68089 Gitignore .ddev/commands/web/live (#2982)
99f25d96 sudo docker-up is no longer needed in Gitpod (#2984) [skip ci][ci skip]

Most of what you want to know is in the v1.17.0 release notes so please check there... Make sure you read the Caveats.

Installation/Upgrade

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

• macOS Homebrew and Linux Linuxbrew: brew install drud/ddev/ddev or brew upgrade drud/ddev/ddev ). (You may need a brew update for homebrew to find the new release.). This works on Apple Silicon Homebrew as well.
• Windows: Use choco upgrade -y 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: ./install_ddev.sh or curl -LO https://raw.githubusercontent.com/drud/ddev/master/scripts/install_ddev.sh && bash install_ddev.sh
• 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.
• In the past, a ddev poweroff was required; now ddev itself detects that you have a new version and asks for permission to do a poweroff.

Key changes for v1.17.2

The primary reason for this release is a composer supply-chain security report. We want to make sure everybody has the fixed version of composer (2.0.13) in ddev composer.

• Please see the v1.17.0 release notes of course.
• Update default composer 2 in web container and ddev composer to 2.0.13
• Improve the example hosting provider integration for Pantheon.
• Add ddev status as an alias for ddev describe
• Remove obsolete DDEV-Live integration and docs

Caveats

• The "live" command script (formerly .ddev/commands/web/live ) is no longer generated, and can be removed (rm .ddev/commands/web/live) - please remove it, as it's obsolete since DDEV-Live has shut down.
• Please see the Caveats in v1.17.0 release notes.

Commits since v1.17.1

1d8f0371 Bump upstream version for v1.17.2 (#2977)
20ac1db4 Remove ddev-live docs and integration, etc (#2976)
efdf7a10 Update README to have correct roadmap link
dc41cb59 Add tests to check for expiring apt keys in images (#2958)
1fc0b952 gitpod: Install docker buildx so we can build images (#2960)
db7efa4f Add ddev status as alias of ddev describe for #2195 (#2955)
e41c2f08 Change pantheon pull to use terminus backup:get (#2957)
6da30080 Clarify Pantheon provider documentation for D6/7 (#2956) [skip ci][ci skip]
5c10806a Delete FUNDING.yml [skip ci][ci skip]

Most of what you want to know is in the v1.17.0 release notes so please check there... Make sure you read the Caveats.

Installation/Upgrade

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

• macOS Homebrew and Linux Linuxbrew: brew install drud/ddev/ddev or brew upgrade drud/ddev/ddev ). (You may need a brew update for homebrew to find the new release.). This works on Apple Silicon Homebrew as well.
• Windows: Use choco upgrade -y 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: ./install_ddev.sh or curl -LO https://raw.githubusercontent.com/drud/ddev/master/scripts/install_ddev.sh && bash install_ddev.sh
• 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.
• In the past, a ddev poweroff was required; now ddev itself detects that you have a new version and asks for permission to do a poweroff.

Key changes for v1.17.1

• Please see the v1.17.0 release notes of course.
• Some folks had trouble with v1.17.0 because they had some key executable things (notably drush) in a nonstandard place, so it wasn't in the $PATH. (Normal place is vendor/bin, but some folks had it in top-level bin directory. This release adds the top-level bin directory (/var/www/html/bin) and also the user bin directory (~/bin) to the $PATH inside the web container, so it may make that less painful.
• The php-imagick extension was missing from PHP7.* in the web container and that's fixed now.

Caveats

Please see the Caveats in v1.17.0 release notes.

Commits since v1.17.0

61e45804 Bump web image tag for v1.17.1 (#2953)
1ab8cb46 Add ~/bin and /var/www/html/bin to PATH in web container (#2949)
c2a6a6e6 Turn off DOCKER_SCAN_SUGGEST to get rid of synk advertising (#2952)
f6f4107f gitpod: Move make into init in .gitpod.yml (#2933) [skip ci][ci skip]
42db893e [docs] Improve Acquia pull integration documentaion (#2936) [skip ci][ci skip]
28b801a5 Fix docs to show available PHP versions including 8.0 (#2941) [skip ci][ci skip]
3369527b Fix docs typo TERMINUS_MACHINE_TOKEN->PLATFORMSH_CLI_TOKEN for Platform (#2951) [skip ci][ci skip]
6400e0e6 Update homebrew formula to fix deprecations, fixes #2942, fixes drud/homebrew-ddev#43 (#2950)
1213bcbb Update Pantheon provider instructions to match yaml. (#2943)
385233b4 Pick up new php-imagick build from upstream, fixes #2934 (#2937)
faa281a1 Updates mkdocs-material to 7.1.1 as well as dependencies (#2948)
8863fb69 Update .gitpod.Dockerfile (#2932) [skip ci][ci skip]
e702a980 blackfire: Fix example command to set blackfire credentials (#2931)

Installation/Upgrade

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

• macOS Homebrew and Linux Linuxbrew: brew install drud/ddev/ddev or brew upgrade drud/ddev/ddev ). (You may need a brew update for homebrew to find the new release.). This works on Apple Silicon Homebrew as well.
• Windows: Use choco upgrade -y 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: ./install_ddev.sh or curl -LO https://raw.githubusercontent.com/drud/ddev/master/scripts/install_ddev.sh && bash install_ddev.sh
• 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.
• In the past, a ddev poweroff was required; now ddev itself detects that you have a new version and asks for permission to do a poweroff.

Key changes for v1.17.0

• Composer v2 is now the default composer version. If you need to change it, use ddev config --composer-version=1 && ddev start
• Brand new provider integration system, with user-configurable and extensible techniques, Acquia, Platform.sh, DDEV-Live, Pantheon.io integration. Integration is user-editable, so it's easy to add, improve, share integrations. There are examples provided for rsync and local file sources. You can ddev pull ddev-live, ddev pull platform, etc.
• ddev push is available for those who want it, although it can be dangerous operation, so make sure it fits your workflow. You can push database and/or files to an upstream hosting provider. Implementation examples are provided and tested for Acquia, DDEV-Live, Pantheon.io, and Platform.sh
• Official support for Apple M1 Silicon with Docker Desktop, see docs
• Excellent improvements to ddev snapshot, including ddev snapshot restore --latest, prompted ddev snapshot restore, ddev snapshot --list, ddev snapshot --cleanup, ddev snapshot --all, thanks to @cmuench !
• ddev snapshot restore now shows progress as it goes, and it doesn't time out on huge snapshot restores. You can also use ddev snapshot restore --latest
• Built-in support for Blackfire.io profiling, with a ddev blackfire command to do it. (docs)
• New ddev config --auto option that configures a project with detected defaults
• Web container environment variables can be set in config.yaml or global_config.yaml with the web_environment key, or ddev config global --web-environment=ENV1=someval,ENV2=someotherval
• ddev heidisql command provides a nice database browser on Windows and Windows WSL2 thanks to @andreashager .
• The PHP default for new projects is now PHP 7.4. A few project types (Drupal 6 and Magento 1) override this to use 5.6.
• The MariaDB default for new projects is 10.3.
• New docs theme! Take a look at [https://ddev.readthedocs.io/) ! Thanks @unn !

Smaller changes

• Drush Launcher is no longer used. Drupal 6 and Drupal 7 projects get Drush 8 directly, and Drupal 8 and 9 must have drush site-installed and it will be found in the $PATH. You can however use "drush8", which is installed in the container as /usr/local/bin/drush8. So you can drush8 status for example.
• You can now configure ddev to fail if a hook task fails by using ddev config —fail-on-hook-fail or fail_on_hook_fail: true in the project or global config, thanks to @majamee
• Drupal8/9 no longer has a custom "working_dir", meaning that ddev ssh and ddev exec land in the project root by default, not in the docroot.
• php8.0 extensions redis and memcached are now included
• sudo is removed from ddev-dbserver and ddev-ssh-agent, and is no longer used in startup routines of ddev-webserver. This is important for long-term security posture, but also is a workaround for a bug in gitpod that was preventing gitpod restores in https://github.com/shaal/ddev-gitpod from working.
• Zend assertions are enabled by default, thanks @heddn!
• ddev start now waits for all containers to come up, not just the "main" ones. So if you have third-party services like solr or elasticsearch, it will wait for them to come up and it will error if they die on the way up.
• You can now use gitpod.io to build ddev and its images for contributing.
• Double nginx's http2_max_header_size to 32k in both ddev-router and web container.
• The script test_ddev.sh is now provided. You can quickly test your ddev installation and provide diagnostic output. This is requested in bug reports. curl -sSL -o /tmp/test_ddev.sh https://raw.githubusercontent.com/drud/ddev/master/scripts/test_ddev.sh && bash /tmp/test_ddev.sh

Caveats

• The provider interface has been completely redone. You no longer have to ddev auth pantheon or ddev config pantheon. Now you ddev pull pantheon (or whatever provider). Please see the docs on the new provider interface, and thank you for testing and reporting your results, questions, issues, bugs!
• Since drush launcher has been removed from the web container, on Drupal 8+ you'll want to make sure your project has composer site-installed (ddev composer require drush/drush). Alternately you can use "drush8" inside the web container.
• Because Drupal8+ no longer has a "working_dir" that lands things on the docroot instead of the project root, you may be surprised if you expect if your docroot is different from your project root and you ddev ssh or ddev exec and expect the working directory to be the docroot. It will now be /var/www/html. This will also affect hooks if they expect a specific directory to execute.
• composer 2 is the default composer version now. If you need composer v1 on a project, ddev config --composer-version=1
• If. you had composer_version: "2"in your project config.yaml it's best to remove that line or set composer_version: "", since version 2 is the default now. ddev config --composer-version="". This also avoids conflicts with webimage_extra_packages.
• The command ddev restore-snapshot became ddev snapshot restore. Use ddev snapshot restore -h for full details.

Commits since v1.16.7

ab690435 Docs fixes for v1.17 [skip ci][ci skip] (#2923)
e83bcd2e Specify remote alias locations for acquia integration (#2926)
f7b53445 Remove commented line in platform example [skip ci][ci skip] (#2927)
c44a0f90 Remove github sponsors from docs/index.md [skip ci][ci skip] (#2925)
1806e163 Make sure drush knows about acquia aliases (#2924)
ab27e62a Change testdata for db backup to env var for ddev-live (#2922)
145c955c Update mkcert-in-Firefox docs; Firefox tab naming changed (#2921) [skip ci][ci skip]
01fd3733 Use upstream hostname instead of IP for upstream in ddev-router, resolves #2805 (#2913)
e2936a23 Fix ddev-live provider example to use actual filename downloaded as db (#2918)
ad4bb666 Remove developer docs from index [skip ci][ci skip] (#2920)
0494942a Minor docs for v1.17 (#2894) [skip ci][ci skip]
7985f71e Revert "Latest docker (version 20) (#2897) [skip ci][ci skip]" (#2915)
0912a37b Use the real ddev-live latest binary (#2912)
f73dd776 Use text template instead of html template, fixes #2908 (#2909)
6bb5384e Fix provider command documentation (#2907) [skip ci][ci skip]
d0c07906 Make test_ddev.sh not need xq, not quit if not found, fixes #2905 (#2906)
9cd9db4b Revert macos_ddev_nfs_setup script because docker mac m1 has gone back to old networking (#2901)
b797fab8 Remove "ddev drush launch" from quickstart in cli-usage.md (#2903) [skip ci][ci skip]
88b7ec4e Killing and restarting docker doesn't work on latest docker for mac (#2900)
46108e3e Bump images to v1.17.0-rc1 (#2895)
9e5228aa Latest docker (version 20) (#2897) [skip ci][ci skip]
d6d5246c [docs only] Use fully-qualified name for service when configuring in client, fixes #2744 [skip ci][ci skip] (#2892)
588f3d9f Test push only on one test system (#2891)
2c1e7aa2 Update brew upgrade command (#2888)
0f9a5b45 Fix broken docs sidebar, fixes #2885 [skip ci][ci skip] (#2893)
6a71501f Include architecture in ddev version, fixes #2884 (#2889)
36beb4fe test_ddev.sh should not depend on other scripts [skip ci][ci skip] (#2890)
532b450e Implement push command and provide examples, fixes #406 (#2875)
1ce024c5 Ongoing docs for completion of ddev v1.17.0 (#2873)
bbbee932 Enabling develop mode in xdebug so we get the pretty stack trace outputs (#2882)
7096adcb Clarify caveat about snapshot compatibility (#2879)
223d4d7a Fix macos_ddev_nfs_setup.sh - was broken on amd64 (#2876)
868e2ea7 Convert from packr2 to go:embed for bundling files, fixes #2343 (#2872)
78b08815 Report WSL2 to segment as separate operating system (#2871)
b606da0f Update acquia.md to fix bug referencing wrong token var (#2869) [skip ci][ci skip]
39bbf6d3 Docs updates for v1.17, including mac M1 update to nfs script, fixes #2792, fixes #2804 (#2868)
7274c32f Use gerardog/gsudo instead of mattn/sudo on Windows sudo.exe (#2864)
1d2cb1d7 Poweroff if new ddev version, fixes #1786 (#2859)
2f28b15d Add a script to parse docker desktop version, change brew cask install (#2865)
28b28c0f Touch up Windows WSL2 hosts file support and docs, rename DRUD_INTERACTIVE, fixes #2533 (#2867)
0a680788 Update Docker Desktop installation instructions with homebrew - no more brew cask install (#2866)
38830685 Make sure missing USER env doesn't cause panic, fixes #2860 (#2862)
cf65c712 Add test_ddev.sh and update the issue templates [skip ci][ci skip] (#2863)
549852c5 Store ddev binary artifacts separately for download (#2861)
d2b41f4d [tests only] Wait a little longer on healthcheck startup (#2855)
ba6d0303 Wait for all containers to come up on ddev start, fixes #2660 (#2848)
8b2e149e Fix snapshot restore progress broken by docker-compose bug (#2854)
6388092b Updates local docs theme to match live with material theme (#2840)
027e8077 Reorganize test scripts, use single generate_artifacts, tests only (#2853)
41e955b8 Drupal 7: drushrc.php coding standards, fixes #2849 (#2850)
6df68761 Use the correct variable name for Pantheon token (#2847)
c74cdb31 [DOCS] Rename AdditionalSettings.php to AdditionalConfiguration.php (#2852) [skip ci][ci skip]
c91110ec Don't let app.Exec() run against non-running container, fixes #1858 (#2830)
5c58c583 Bump NSIS to 3.06.1 in CircleCI test build (#2659)
80c076e9 Enable zend assertions by default (#2833)
2e3d2a3c Add circleci-based arm64 testing (#2845)
6129763e Improve acquia provider config example, add guardrails for other providers (#2842)
8bf1cb21 move gitpod docker-up to a "secondary" terminal (#2841) [skip ci][ci skip]
c70f2989 Use composer version 2 as default (#2835)
8cf313e1 Be way less aggressive with removing CREATE DATABASE or USE statements in ddev import-db, fixes #2787 (#2831)
21a98d8f Reintroduce magerun and magerun2 (#2829)
37e83c0a Fix acquia provider integration broken by upstream (Acquia) bug (#2837)
b2fb7434 Add gitpod support to ddev repository [skip ci][ci skip] (#2838)
7e5acd61 PhpMyAdmin test in TestDdevFullSiteSetup started failing because of upstream image change (#2836)
1053f058 Adds mime type for compressed javascript and css with a .gzip extension to fix TYPO3 compression problem (#2783)
52e4d9db [tests only] Add linux types for buildkite-agent (#2828)
78d2e2e5 Strip _ce from docker version if added by some linux distros, fixes #2815 (#2823)
737f5cd3 Fixes a xdebug config reference, which has changed since DDEV updated… (#2827) [skip ci][ci skip]
5f9dba0d Begin buildkite testing with mac M1 and WSL2, fixes #2288 (#2818)
3c12369b Minor fix to circleci container test (#2825)
0a022bed Experiment with removing chown from ddev-ssh-agent startup script (#2816)
dc26ba17 [docs][tests] Ongoing docs work and lighten up on markdownlint (#2819)
2351b1f4 [tests only] git install bats-core since it doesn't seem to be working from package (#2820)
25897130 Use only go 1.16 now that it's released (#2814)
4715231e Bump upstream for ddev-webserver from php 8.0.2, etc. (#2813)
42ffa6bf Remove sudo from ddev-dbserver and ddev-ssh-agent, limit use in ddev-webserver, fixes #2607 (#2806)
d68ef2ad Process /var/lock/apache2 in ddev-webserver Dockerfile, fixes #2799 (#2809)
8ac90f37 Remove .DS_Store files before restoring snapshot, fixes #2765 (#2810)
d62f87c2 Refactor ddev-dbserver builds (#2808)
67bff55c Provider refactor followups (#2800)
7165d70d [docs] Update OSX install step order for clarity. (#2793) [skip ci][ci skip]
751405a9 Ongoing docs updates [skip ci][ci skip] (#2781)
b0ba7ff9 Acquia hosting integration, fixes #2681, fixes #905 (#2796)
edf85add Remove special host.docker.internal handling for mac M1 (#2790)
37ac5f08 Large snapshot restore shouldn't return until it's done and should show status (#2747)
3c459457 Provider cleanup and completion (#2788)
0fb72e3b Fix minor formatting issue in Additional Project Hostnames documentation (#2789) [skip ci][ci skip]
6acd654c Re-implement DDEV-Live provider integration (#2784)
67495eda Rework Pantheon integration to use new yaml-based technique (#2782)
3f611980 Adds Drush site:install and uli to D8 and D9 quickstart (#2780)
29078ab8 Update index.md - link to brew.sh was not correct (#2777) [skip ci][ci skip]
f8a26d2e Platform.sh and generic hosting provider integration, fixes #2384, fixes #2194 (#2763)
78b99e4e Use updated upstream for yarn fix, fixes #2772 (#2775)
41d3f266 Miscellaneous docs fixes [skip ci][ci skip] (#2748)
4a0767a4 Minor test improvements (tests only) (#2771)
a2050531 [docs] Fix typo in step-debugging.md (#2774) [skip ci][ci skip]
5653ef3e Update in-container-configuration.md (#2770)
8c939be0 Remove magerun from web container as people use composer-installed version (#2768)
5b75fa9f Testcache was wrong for circleci (CircleCI tests only) (#2766)
2fc5203c Use go 1.16-rc1 to build M1 builds (#2764)
0df5360d Remove several circleci jobs as github actions is doing them (#2761)
e68cc349 Improve DDEV configuration validation errors (php_version, mysql_version, etc.) (#2745)
40940783 Turn off buildkit build in ddev start (docker-compose) (#2758)
170cd194 Bring in php8.0 extensions redis and memcached from upstream (#2759)
9db9035d Improve fragile test TestComposeStreams (#2757)
37826a48 MariaDB default didn't get changed to 10.3 for M1 (#2750)
56830ff0 Remove drush launcher config from web image [skip ci][ci skip] (#2749)
10b71d9b Add Blackfire agent and full support (#2448)
17ee510a Hardened webserver needs to allow /usr/local/bin update, fixes #2725 (#2743)
5427087d Use default_server in nginx configs instead of server_name _, fixes #2729 (#2731)
7a7e4a39 Stop setting working_dir to docroot in Drupal8+, fixes #2534 (#2734)
d73268c4 Add ddev config --auto, fixes #1096 (#2733)
1d9931f8 Allow setting web environment in config.yaml, fixes #871 (#2742)
d374ae91 Give an error on duplicate snapshot anme, fixes #2515 (#2739)
51ede53c Improve snapshot restore with --latest, prompting, move to ddev snapshot restore, fixes #1886, fixes #1163 (#2724)
a7cb1488 Use GitHub Actions for linux tests, fixes #2604 (#2615)
32db28e6 Do static checking in github action (#2738)
a66f4e67 Spellcheck docs, fixes #2365 (#2735)
0c2af6bf add PHP 8.0 to the supported php versions (#2736) [skip ci][ci skip]
a12c41fe Skip TestGetLocalHTTPResponse on Windows (#2732)
547e10fb [docs] Update maintained badge on README (#2728)
a1c1f5d9 Remove duplicate menu entry for shell autocompletion in docs (#2726)
70df9b2e Bump PHP default to php7.4, fixes #2657 (#2716)
dd8369b8 Miscellaneous docs fixes (#2695) [skip ci][ci skip]
ffd96db2 [docs] Add "Limitations using ddev composer" for #2547 (#2718) [skip ci][ci skip]
0ef1b0ca [docs only] TYPO fixes (#2723) [skip ci]
85e656f9 Add --list and --cleanup options to snapshot command, for #1163 (#2701)
67f99f51 Stop using drush launcher, use drush8 for drupal6/7, fixes #2514 (#2720)
900d4649 Experimental support for Apple Silicon M1 (darwin_arm64), fixes #2338 (#2687)
06887036 Update spf/cobra and dependencies for #2702 (#2715)
d1b68e4b Bump default mariadb version to 10.3, fixes #2232 (#2717)
b6c6f067 Double nginx's http2_max_header_size to 32k, fixes #2697 (#2698)
bc1d660b TestServices has been failing a lot, give solr a little time to come up (#2714)
5491d0c1 Ignore drushrc.php writing when settings disabled (#2684)
2ff4f0b1 Create new HeidiSQL command for Windows and WSL2 (#2679)
d86db92b Update cli-usage.md for bedrock (#2699)
5d17f0e5 Allow configuration to fail when a hook execution fails, fixes #2536 (#2652)
4ab01db3 Improve 3rd-party Apache SOLR setup in additional-services.md (#2670) [skip ci][ci skip]
e93110bc [tests only, circleci] Use Ubuntu 20.04 for builds, bump cache, build makemsis from source (#2713)
95a6f48d auth ssh command had out of date switch in long description (#2711) [skip ci][ci skip]
d8a2e49d Use TYPO3 11 for installations by default (#2707) [skip ci][ci skip]

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.). This now works on Apple Silicon Homebrew as well.
• 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.17.0-rc2

• There are only minor bug/documentation/testing fixes since rc1.
• The headline remains the ddev push implementation and the general provider integration. You can now pull and push database and files. See the new provider integration system, with user-configurable and extensible techniques, Acquia, Platform.sh, DDEV-Live, Pantheon.io integration. Integration is user-editable, so it's easy to add, improve, share integrations. There are examples provided for rsync and local file sources, see the Introduction.

You can see the full provisional v1.17.0 release notes here, with everything that's happened since v1.16.

Instructions for Apple M1

1. Docker: as of 2021-03-27 the currently listed Docker M1 Tech Preview RC2 is working great, fixing a number of significant problems.
2. Use a terminal app that is not running. under Rosetta 2. So for example, if using iTerm, the "get info" checkbox should NOT say "Open using Rosetta".
3. Install with Apple Silicon Homebrew (in /opt/homebrew) or using the install_ddev.sh v1.17.0-rc2 script as above.
4. Check to make sure you got the arm64 version of ddev. ddev version should show it being "architecture: arm64".
5. ddev --version should show the right version
6. To get NFS going, you can re-run the script that sets it up, which is now Apple M1 friendly, curl -O https://raw.githubusercontent.com/drud/ddev/master/scripts/macos_ddev_nfs_setup.sh && chmod +x macos_ddev_nfs_setup.sh && ./macos_ddev_nfs_setup.sh Note that if you just upgraded to the docker desktop RC2 you'll need to run this again, as they changed back to the old networking.

Commits since v1.17.0-rc1

0912a37b Use the real ddev-live latest binary (#2912)
f73dd776 Use text template instead of html template, fixes #2908 (#2909)
6bb5384e Fix provider command documentation (#2907) [skip ci][ci skip]
d0c07906 Make test_ddev.sh not need xq, not quit if not found, fixes #2905 (#2906)
9cd9db4b Revert macos_ddev_nfs_setup script because docker mac m1 has gone back to old networking (#2901)
b797fab8 Remove "ddev drush launch" from quickstart in cli-usage.md (#2903) [skip ci][ci skip]
88b7ec4e Killing and restarting docker doesn't work on latest docker for mac (#2900)

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.). This now works on Apple Silicon Homebrew as well.
• 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.17.0-rc1

• The headline remains the ddev push implementation and the general provider integration. You can now pull and push database and files. See the new provider integration system, with user-configurable and extensible techniques, Acquia, Platform.sh, DDEV-Live, Pantheon.io integration. Integration is user-editable, so it's easy to add, improve, share integrations. There are examples provided for rsync and local file sources, see the Introduction.

You can see the full provisional v1.17.0 release notes here, with everything that's happened since v1.16.

Instructions for Apple M1

1. Docker: as of 2021-03-27 the currently listed Docker M1 Tech Preview RC2 is working great, fixing a number of significant problems.
2. Use a terminal app that is not running. under Rosetta 2. So for example, if using iTerm, the "get info" checkbox should NOT say "Open using Rosetta".
3. Install with Apple Silicon Homebrew (in /opt/homebrew) or using the install_ddev.sh v1.17.0-rc1 script as above.
4. Check to make sure you got the arm64 version of ddev. ddev version should show it being "architecture: arm64".
5. ddev --version should show the right version
6. To get NFS going, you can re-run the script that sets it up, which is now Apple M1 friendly, curl -O https://raw.githubusercontent.com/drud/ddev/master/scripts/macos_ddev_nfs_setup.sh && chmod +x macos_ddev_nfs_setup.sh && ./macos_ddev_nfs_setup.sh Note that if you just upgraded to the docker desktop RC2 you'll need to run this again, as they changed back to the old networking.

Commits since v1.17.0-alpha8

46108e3e Bump images to v1.17.0-rc1 (#2895)
9e5228aa Latest docker (version 20) (#2897) [skip ci][ci skip]
d6d5246c [docs only] Use fully-qualified name for service when configuring in client, fixes #2744 [skip ci][ci skip] (#2892)
588f3d9f Test push only on one test system (#2891)
2c1e7aa2 Update brew upgrade command (#2888)
0f9a5b45 Fix broken docs sidebar, fixes #2885 [skip ci][ci skip] (#2893)
6a71501f Include architecture in ddev version, fixes #2884 (#2889)
36beb4fe test_ddev.sh should not depend on other scripts [skip ci][ci skip] (#2890)

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.). This now works on Apple Silicon Homebrew as well.
• 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.17.0-alpha8

• The headline is the ddev push implementation. You can now push database and files. This is an extension of the new provider integration system, with user-configurable and extensible techniques, Acquia, Platform.sh, DDEV-Live, Pantheon.io integration. Integration is user-editable, so it's easy to add, improve, share integrations. There are examples provided for rsync and local file sources, see the Introduction.
• The provider implementation examples for ddev pull have shifted just a bit, so if you've been testing them you may want to look at the new ones.
• When xdebug is on, the xdebug develop mode is on, which gives pretty stack traces and error information. Thanks to @graham73may !
• On upgrade (so this is the first time you'll see it) ddev start asks you for permission to ddev poweroff to avoid weird situations where old containers are running with new ddev code.

You can see the full provisional v1.17.0 release notes here, with everything that's happened since v1.16.

Instructions for Apple M1

1. Install the Docker Tech Preview. Edit: as of 2021-03-20 the currently listed docker preview is nonfunctional, so you'll need to use the previous one, build 60902
2. Use a terminal app that is not running. under Rosetta 2. So for example, if using iTerm, the "get info" checkbox should NOT say "Open using Rosetta".
3. Install with Apple Silicon Homebrew (in /opt/homebrew) or using the install_ddev.sh v1.17.0-alpha8 script as above.
4. Check to make sure you got the arm64 version of ddev. file or file /opt/homebrew/bin/ddev should show "/opt/homebrew/bin/ddev: Mach-O 64-bit executable arm64". If it shows amd64, you have the wrong version of ddev.
5. ddev --version should show the right version
6. To get NFS going, there is a difference in networking. You can re-run the script that sets it up, which is now Apple M1 friendly, curl -O https://raw.githubusercontent.com/drud/ddev/master/scripts/macos_ddev_nfs_setup.sh && chmod +x macos_ddev_nfs_setup.sh && ./macos_ddev_nfs_setup.sh

Commits since v1.17.0-alpha7

532b450e Implement push command and provide examples, fixes #406 (#2875)
1ce024c5 Ongoing docs for completion of ddev v1.17.0 (#2873)
bbbee932 Enabling develop mode in xdebug so we get the pretty stack trace outputs (#2882)
7096adcb Clarify caveat about snapshot compatibility (#2879)
223d4d7a Fix macos_ddev_nfs_setup.sh - was broken on amd64 (#2876)
868e2ea7 Convert from packr2 to go:embed for bundling files, fixes #2343 (#2872)
78b08815 Report WSL2 to segment as separate operating system (#2871)
b606da0f Update acquia.md to fix bug referencing wrong token var (#2869) [skip ci][ci skip]
39bbf6d3 Docs updates for v1.17, including mac M1 update to nfs script, fixes #2792, fixes #2804 (#2868)
7274c32f Use gerardog/gsudo instead of mattn/sudo on Windows sudo.exe (#2864)
1d2cb1d7 Poweroff if new ddev version, fixes #1786 (#2859)
2f28b15d Add a script to parse docker desktop version, change brew cask install (#2865)
28b28c0f Touch up Windows WSL2 hosts file support and docs, rename DRUD_INTERACTIVE, fixes #2533 (#2867)
0a680788 Update Docker Desktop installation instructions with homebrew - no more brew cask install (#2866)
38830685 Make sure missing USER env doesn't cause panic, fixes #2860 (#2862)
cf65c712 Add test_ddev.sh and update the issue templates [skip ci][ci skip] (#2863)
549852c5 Store ddev binary artifacts separately for download (#2861)
d2b41f4d [tests only] Wait a little longer on healthcheck startup (#2855)

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.). This now works on Apple Silicon Homebrew as well.
• 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.17.0-alpha7

• Composer v2 is now the default composer version.
• New docs theme! Take a look at https://ddev.readthedocs.io/en/latest/ ! Thanks @unn !
• ddev start now waits for all containers to come up, not just the "main" ones. So if you have third-party services like solr or elasticsearch, it will wait for them to come up and it will error if they die on the way up.
• Improvements to the new redesigned hosting provider integration. Please keep testing this! Acquia, Platform.sh, DDEV-Live, Pantheon.io integration. Integration is user-editable, so it's easy to add, improve, share new integrations. There are examples provided for rsync and local file sources.
• Zend assertions are enabled by default, thanks @heddn!
• magerun and magerun2 are back in the web container
• WSl2 and Apple M1 automated testing

Instructions for Apple M1

1. Install the Docker Tech Preview. Note that xdebug and perhaps some other features won't work with earlier preview releases, like preview7, so you'll want the current one.
2. Use a terminal app that is not running. under Rosetta 2. So for example, if using iTerm, the "get info" checkbox should NOT say "Open using Rosetta".
3. Install with Apple Silicon Homebrew (in /opt/homebrew) or using the install_ddev.sh v1.17.0-alpha7 script as above.
4. Check to make sure you got the arm64 version of ddev. file or file /opt/homebrew/bin/ddev should show "/opt/homebrew/bin/ddev: Mach-O 64-bit executable arm64". If it shows amd64, you have the wrong version of ddev.
5. ddev --version should show the right version
6. To get NFS going, there is a difference in networking. You have to find out the eth0 interface inside the container. Find the source IP for NFS by running docker run -it --rm busybox sh -c 'ping -c1 vm.docker.internal | awk "/PING/ { gsub(/[\(\):]/, \"\"); print \$3 }"' That IP range (probably 192.168.64.0) should then be added to your /etc/exports like this:

/Users/rfay -alldirs -mapall=501:20 -network=192.168.64.0 -mask 255.255.255.0

Commits since v1.17.0-alpha6

ba6d0303 Wait for all containers to come up on ddev start, fixes #2660 (#2848)
8b2e149e Fix snapshot restore progress broken by docker-compose bug (#2854)
6388092b Updates local docs theme to match live with material theme (#2840)
027e8077 Reorganize test scripts, use single generate_artifacts, tests only (#2853)
41e955b8 Drupal 7: drushrc.php coding standards, fixes #2849 (#2850)
6df68761 Use the correct variable name for Pantheon token (#2847)
c74cdb31 [DOCS] Rename AdditionalSettings.php to AdditionalConfiguration.php (#2852) [skip ci][ci skip]
c91110ec Don't let app.Exec() run against non-running container, fixes #1858 (#2830)
5c58c583 Bump NSIS to 3.06.1 in CircleCI test build (#2659)
80c076e9 Enable zend assertions by default (#2833)
2e3d2a3c Add circleci-based arm64 testing (#2845)
6129763e Improve acquia provider config example, add guardrails for other providers (#2842)
8bf1cb21 move gitpod docker-up to a "secondary" terminal (#2841) [skip ci][ci skip]
c70f2989 Use composer version 2 as default (#2835)
8cf313e1 Be way less aggressive with removing CREATE DATABASE or USE statements in ddev import-db, fixes #2787 (#2831)
21a98d8f Reintroduce magerun and magerun2 (#2829)
37e83c0a Fix acquia provider integration broken by upstream (Acquia) bug (#2837)
b2fb7434 Add gitpod support to ddev repository [skip ci][ci skip] (#2838)
7e5acd61 PhpMyAdmin test in TestDdevFullSiteSetup started failing because of upstream image change (#2836)
1053f058 Adds mime type for compressed javascript and css with a .gzip extension to fix TYPO3 compression problem (#2783)
52e4d9db [tests only] Add linux types for buildkite-agent (#2828)
78d2e2e5 Strip _ce from docker version if added by some linux distros, fixes #2815 (#2823)
737f5cd3 Fixes a xdebug config reference, which has changed since DDEV updated… (#2827) [skip ci][ci skip]
5f9dba0d Begin buildkite testing with mac M1 and WSL2, fixes #2288 (#2818)
3c12369b Minor fix to circleci container test (#2825)
0a022bed Experiment with removing chown from ddev-ssh-agent startup script (#2816)
dc26ba17 [docs][tests] Ongoing docs work and lighten up on markdownlint (#2819)
2351b1f4 [tests only] git install bats-core since it doesn't seem to be working from package (#2820)

This release only prepares the web image for expiration of an upstream key and release of a new key.

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: 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.)
• Windows: Use choco upgrade -y ddev to get this one, or download the ddev_windows_installer below.
• Linux and macOS with the install_ddev.sh script: curl -LO https://raw.githubusercontent.com/drud/ddev/master/scripts/install_ddev.sh && bash install_ddev.sh
• 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.16.7

• For the big stuff in v1.16, please read v1.16.0 release notes
• Update a key for the deb.sury.org repository, as it will expire March 17, 2021.
• This also updates all packages in the container, so gets the latest PHP versions, like PHP 8.0.2

Commits since v1.16.6

217247a4 Update to new deb.sury.org key, fixes #2832 (#2834)

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.). This now works on Apple Silicon Homebrew as well.
• 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.17.2-alpha6

• sudo is removed from ddev-dbserver and ddev-ssh-agent, and is no longer used in startup routines of ddev-webserver. This is important for long-term security posture, but also is a workaround for a bug in gitpod that was preventing gitpod restores in https://github.com/shaal/ddev-gitpod from working.
• All binaries are now built using just-released go 1.16, so we no longer have to have two different go binaries to get mac M1 builds and all the rest built.
• Upstream PHP image has been rebuilt, so it has the latest packages, including PHP 8.0.2

Instructions for Apple M1

1. Install the Docker Tech Preview. Note that xdebug and perhaps some other features won't work with earlier preview releases, like preview7, so you'll want the current one.
2. Use a terminal app that is not running. under Rosetta 2. So for example, if using iTerm, the "get info" checkbox should NOT say "Open using Rosetta".
3. Install with Apple Silicon Homebrew (in /opt/homebrew) or using the install_ddev.sh v1.17.0-alpha6 script as above.
4. Check to make sure you got the arm64 version of ddev. file or file /opt/homebrew/bin/ddev should show "/opt/homebrew/bin/ddev: Mach-O 64-bit executable arm64". If it shows amd64, you have the wrong version of ddev.
5. ddev --version should show the right version
6. To get NFS going, there is a difference in networking. You have to find out the eth0 interface inside the container. Find the source IP for NFS by running docker run -it --rm busybox sh -c 'ping -c1 vm.docker.internal | awk "/PING/ { gsub(/[\(\):]/, \"\"); print \$3 }"' That IP range (probably 192.168.64.0) should then be added to your /etc/exports like this:

/Users/rfay -alldirs -mapall=501:20 -network=192.168.64.0 -mask 255.255.255.0

Commits since v1.17.0-alpha5

25897130 Use only go 1.16 now that it's released (#2814)
4715231e Bump upstream for ddev-webserver from php 8.0.2, etc. (#2813)
42ffa6bf Remove sudo from ddev-dbserver and ddev-ssh-agent, limit use in ddev-webserver, fixes #2607 (#2806)
d68ef2ad Process /var/lock/apache2 in ddev-webserver Dockerfile, fixes #2799 (#2809)
8ac90f37 Remove .DS_Store files before restoring snapshot, fixes #2765 (#2810)
d62f87c2 Refactor ddev-dbserver builds (#2808)

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.). This now works on Apple Silicon Homebrew as well.
• 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.17.2-alpha5

• Brand new provider integration system, with user-configurable and extensible techniques, Acquia, Platform.sh, DDEV-Live, Pantheon.io integration. Integration is user-editable, so it's easy to add, improve, share new integrations. There are examples provided for rsync and local file sources.
• Improved support for Apple M1 Silicon (latest). Mostly we don't have to work around so many things. See instructions below, which are greatly reduced; mostly you don't have to do anything but update the /etc/exports if you use NFS.
• Snapshot restore now shows progress as it goes, and it doesn't time out on huge snapshot restores.

Instructions for Apple M1

1. Install the Docker Tech Preview. Note that xdebug and perhaps some other features won't work with earlier preview releases, like preview7, so you'll want the current one.
2. Use a terminal app that is not running. under Rosetta 2. So for example, if using iTerm, the "get info" checkbox should NOT say "Open using Rosetta".
3. Install with Apple Silicon Homebrew (in /opt/homebrew) or using the install_ddev.sh v1.17.0-alpha5 script as above.
4. Check to make sure you got the arm64 version of ddev. file or file /usr/local/bin/ddev should show "/usr/local/bin/ddev: Mach-O 64-bit executable arm64". If it shows amd64, you have the wrong version of ddev.
5. ddev --version should show the right version
6. To get NFS going, there is a difference in networking. You have to find out the eth0 interface inside the container. Find the source IP for NFS by running docker run -it --rm busybox sh -c 'ping -c1 vm.docker.internal | awk "/PING/ { gsub(/[\(\):]/, \"\"); print \$3 }"' That IP range (probably 192.168.64.0) should then be added to your /etc/exports like this:

/Users/rfay -alldirs -mapall=501:20 -network=192.168.64.0 -mask 255.255.255.0

Commits since v1.16.5

67bff55c5 Provider refactor followups (#2800)
7165d70d0 [docs] Update OSX install step order for clarity. (#2793)
751405a96 Ongoing docs updates [skip ci][ci skip] (#2781)
b0ba7ff90 Acquia hosting integration, fixes #2681, fixes #905 (#2796)
edf85add7 Remove special host.docker.internal handling for mac M1 (#2790)
37ac5f089 Large snapshot restore shouldn't return until it's done and should show status (#2747)
3c4594578 Provider cleanup and completion (#2788)
0fb72e3bc Fix minor formatting issue in Additional Project Hostnames documentation (#2789)
6acd654cf Re-implement DDEV-Live provider integration (#2784)
67495eda0 Rework Pantheon integration to use new yaml-based technique (#2782)
3f6119805 Adds Drush site:install and uli to D8 and D9 quickstart (#2780)
29078ab82 Update index.md - link to brew.sh was not correct (#2777) [skip ci][ci skip]
f8a26d2ec Platform.sh and generic hosting provider integration, fixes #2384, fixes #2194 (#2763)
78b99e4e8 Use updated upstream for yarn fix, fixes #2772 (#2775)
41d3f266c Miscellaneous docs fixes [skip ci][ci skip] (#2748)
4a0767a46 Minor test improvements (tests only) (#2771)
a2050531a [docs] Fix typo in step-debugging.md (#2774) [skip ci][ci skip]
5653ef3ee Update in-container-configuration.md (#2770)
8c939be09 Remove magerun from web container as people use composer-installed version (#2768)
5b75fa9fe Testcache was wrong for circleci (CircleCI tests only) (#2766)
2fc5203c5 Use go 1.16-rc1 to build M1 builds (#2764)
0df5360db Remove several circleci jobs as github actions is doing them (#2761)
e68cc3498 Improve DDEV configuration validation errors (php_version, mysql_version, etc.) (#2745)
40940783a Turn off buildkit build in ddev start (docker-compose) (#2758)
170cd1947 Bring in php8.0 extensions redis and memcached from upstream (#2759)
9db9035de Improve fragile test TestComposeStreams (#2757)
37826a483 MariaDB default didn't get changed to 10.3 for M1 (#2750)
56830ff00 Remove drush launcher config from web image [skip ci][ci skip] (#2749)
10b71d9b6 Add Blackfire agent and full support (#2448)
17ee510a2 Hardened webserver needs to allow /usr/local/bin update, fixes #2725 (#2743)
5427087df Use default_server in nginx configs instead of server_name _, fixes #2729 (#2731)
7a7e4a39c Stop setting working_dir to docroot in Drupal8+, fixes #2534 (#2734)
d73268c43 Add ddev config --auto, fixes #1096 (#2733)
1d9931f8b Allow setting web environment in config.yaml, fixes #871 (#2742)
d374ae91f Give an error on duplicate snapshot anme, fixes #2515 (#2739)
51ede53c7 Improve snapshot restore with --latest, prompting, move to ddev snapshot restore, fixes #1886, fixes #1163 (#2724)
a7cb1488d Use GitHub Actions for linux tests, fixes #2604 (#2615)
32db28e66 Do static checking in github action (#2738)
a66f4e677 Spellcheck docs, fixes #2365 (#2735)
0c2af6bf5 add PHP 8.0 to the supported php versions (#2736) [skip ci][ci skip]
a12c41fe4 Skip TestGetLocalHTTPResponse on Windows (#2732)
547e10fb2 [docs] Update maintained badge on README (#2728)
a1c1f5d97 Remove duplicate menu entry for shell autocompletion in docs (#2726)
70df9b2e3 Bump PHP default to php7.4, fixes #2657 (#2716)
dd8369b8b Miscellaneous docs fixes (#2695) [skip ci][ci skip]
ffd96db2c [docs] Add "Limitations using ddev composer" for #2547 (#2718) [skip ci][ci skip]
0ef1b0ca0 [docs only] TYPO fixes (#2723) [skip ci]
85e656f95 Add --list and --cleanup options to snapshot command, for #1163 (#2701)
67f99f515 Stop using drush launcher, use drush8 for drupal6/7, fixes #2514 (#2720)
900d46495 Experimental support for Apple Silicon M1 (darwin_arm64), fixes #2338 (#2687)
06887036c Update spf/cobra and dependencies for #2702 (#2715)
d1b68e4b8 Bump default mariadb version to 10.3, fixes #2232 (#2717)
b6c6f0679 Double nginx's http2_max_header_size to 32k, fixes #2697 (#2698)
bc1d660bd TestServices has been failing a lot, give solr a little time to come up (#2714)
5491d0c1b Ignore drushrc.php writing when settings disabled (#2684)
2ff4f0b17 Create new HeidiSQL command for Windows and WSL2 (#2679)
d86db92b0 Update cli-usage.md for bedrock (#2699)
5d17f0e5d Allow configuration to fail when a hook execution fails, fixes #2536 (#2652)
4ab01db3c Improve 3rd-party Apache SOLR setup in additional-services.md (#2670) [skip ci][ci skip]
e93110bc3 [tests only, circleci] Use Ubuntu 20.04 for builds, bump cache, build makemsis from source (#2713)
95a6f48d5 auth ssh command had out of date switch in long description (#2711) [skip ci][ci skip]
d8a2e49d9 Use TYPO3 11 for installations by default (#2707) [skip ci][ci skip]

This release is primarily to work around an upstream (annual) problem with the yarn repository. See #2772

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.). This now works on Apple Silicon Homebrew as well.
• 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.17.2-alpha4

• A fix to the yarn repository from #2772. This problem won't affect everybody, but it will affect anybody who uses webimage_extra_packages or does apt-get update in a custom Dockerfile.
• /usr/local/bin/magerun has been removed from the web container, as people should use the composer-installed bin/magento
• Bring in php8.0 extensions redis and memcached from upstream

Instructions and Workarounds for Apple M1

1. Install the Docker Tech Preview.
2. Use a terminal app that is not running. under Rosetta 2. So for example, if using iTerm, the "get info" checkbox should NOT say "Open using Rosetta".
3. Install with Apple Silicon Homebrew (in /opt/homebrew) or using the install_ddev.sh v1.17.0-alpha4 script as above.
4. Check to make sure you got the arm64 version of ddev. file or file /usr/local/bin/ddev should show "/usr/local/bin/ddev: Mach-O 64-bit executable arm64". If it shows amd64, you have the wrong version of ddev.
5. ddev --version should show the right version
6. The Docker Tech Preview 7 does not yet provide the hostname "host.docker.internal" inside the container. On my machine it's 192.168.64.1, and may be the same on yours. You can find out what it is (temporary hack) by docker run -it --rm alpine nslookup junker99.com - the "Server" reported in the failed lookup seems to be host.docker.internal. If yours is not 192.168.64.1, then put what yours is into ~/.ddev/global_config.yaml host_docker_internal: xxx.xxx.xxx.xxx
7. Once that works, you should be able to debug with an IDE like PHPStorm (and PHPStorm now has a full Apple Silicon build
8. To get NFS going, there seems to be a difference in networking. Take the IP you found for host.docker.internal and add one and add it to /etc/exports in addition to "localhost". Mine ended up like this:

/Users/rfay -alldirs -mapall=501:20 localhost
/Users/rfay -alldirs -mapall=501:20 192.168.64.2

I was able to figure this out by running Console.app and searching for nfsd and watching for the failure IP address when I ran ddev debug nfsmount.

I'm happy to help you debug this, so ping me (rfay) on slack, or any other support venue

Commits since v1.16.5

78b99e4e8 Use updated upstream for yarn fix, fixes #2772 (#2775)
41d3f266c Miscellaneous docs fixes [skip ci][ci skip] (#2748)
4a0767a46 Minor test improvements (tests only) (#2771)
a2050531a [docs] Fix typo in step-debugging.md (#2774) [skip ci][ci skip]
5653ef3ee Update in-container-configuration.md (#2770)
8c939be09 Remove magerun from web container as people use composer-installed version (#2768)
5b75fa9fe Testcache was wrong for circleci (CircleCI tests only) (#2766)
2fc5203c5 Use go 1.16-rc1 to build M1 builds (#2764)
0df5360db Remove several circleci jobs as github actions is doing them (#2761)
e68cc3498 Improve DDEV configuration validation errors (php_version, mysql_version, etc.) (#2745)
40940783a Turn off buildkit build in ddev start (docker-compose) (#2758)
170cd1947 Bring in php8.0 extensions redis and memcached from upstream (#2759)
9db9035de Improve fragile test TestComposeStreams (#2757)
37826a483 MariaDB default didn't get changed to 10.3 for M1 (#2750)
56830ff00 Remove drush launcher config from web image [skip ci][ci skip] (#2749)
10b71d9b6 Add Blackfire agent and full support (#2448)
17ee510a2 Hardened webserver needs to allow /usr/local/bin update, fixes #2725 (#2743)
5427087df Use default_server in nginx configs instead of server_name _, fixes #2729 (#2731)
7a7e4a39c Stop setting working_dir to docroot in Drupal8+, fixes #2534 (#2734)
d73268c43 Add ddev config --auto, fixes #1096 (#2733)
1d9931f8b Allow setting web environment in config.yaml, fixes #871 (#2742)
d374ae91f Give an error on duplicate snapshot anme, fixes #2515 (#2739)
51ede53c7 Improve snapshot restore with --latest, prompting, move to ddev snapshot restore, fixes #1886, fixes #1163 (#2724)
a7cb1488d Use GitHub Actions for linux tests, fixes #2604 (#2615)
32db28e66 Do static checking in github action (#2738)
a66f4e677 Spellcheck docs, fixes #2365 (#2735)
0c2af6bf5 add PHP 8.0 to the supported php versions (#2736) [skip ci][ci skip]
a12c41fe4 Skip TestGetLocalHTTPResponse on Windows (#2732)
547e10fb2 [docs] Update maintained badge on README (#2728)
a1c1f5d97 Remove duplicate menu entry for shell autocompletion in docs (#2726)
70df9b2e3 Bump PHP default to php7.4, fixes #2657 (#2716)
dd8369b8b Miscellaneous docs fixes (#2695) [skip ci][ci skip]
ffd96db2c [docs] Add "Limitations using ddev composer" for #2547 (#2718) [skip ci][ci skip]
0ef1b0ca0 [docs only] TYPO fixes (#2723) [skip ci]
85e656f95 Add --list and --cleanup options to snapshot command, for #1163 (#2701)
67f99f515 Stop using drush launcher, use drush8 for drupal6/7, fixes #2514 (#2720)
900d46495 Experimental support for Apple Silicon M1 (darwin_arm64), fixes #2338 (#2687)
06887036c Update spf/cobra and dependencies for #2702 (#2715)
d1b68e4b8 Bump default mariadb version to 10.3, fixes #2232 (#2717)
b6c6f0679 Double nginx's http2_max_header_size to 32k, fixes #2697 (#2698)
bc1d660bd TestServices has been failing a lot, give solr a little time to come up (#2714)
5491d0c1b Ignore drushrc.php writing when settings disabled (#2684)
2ff4f0b17 Create new HeidiSQL command for Windows and WSL2 (#2679)
d86db92b0 Update cli-usage.md for bedrock (#2699)
5d17f0e5d Allow configuration to fail when a hook execution fails, fixes #2536 (#2652)
4ab01db3c Improve 3rd-party Apache SOLR setup in additional-services.md (#2670) [skip ci][ci skip]
e93110bc3 [tests only, circleci] Use Ubuntu 20.04 for builds, bump cache, build makemsis from source (#2713)
95a6f48d5 auth ssh command had out of date switch in long description (#2711) [skip ci][ci skip]
d8a2e49d9 Use TYPO3 11 for installations by default (#2707) [skip ci][ci skip]

This release is the same as v1.16.5 except the yarn installation is done differently to work around an upstream (annual) problem with the yarn repository. See #2772

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: 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.)
• Windows: Use choco upgrade -y ddev to get this one, or download the ddev_windows_installer below.
• Linux and macOS with the install_ddev.sh script: curl -LO https://raw.githubusercontent.com/drud/ddev/master/scripts/install_ddev.sh && bash install_ddev.sh
• 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.16.6

• For the big stuff in v1.16, please read v1.16.0 release notes
• There is nothing here except a fix to the yarn repository from #2772. This problem won't affect everybody, but it will affect anybody who uses webimage_extra_packages or does apt-get update in a custom Dockerfile.

Commits since v1.16.5

987252638 Update yarn install to fix replaced yarnpkg key, fixes #2772 (#2773)

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.). This now works on Apple Silicon Homebrew as well.
• 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.17.2-alpha3

• Excellent improvements to ddev snapshot, including ddev snapshot restore --latest, prompted ddev snapshot restore, ddev snapshot --list, ddev snapshot --cleanup, thanks to @cmuench !
• Explicit support for Blackfire.io profiling, with a ddev blackfire command to do it. (docs)
• New ddev config --auto option that configures a project with detected defaults
• Web container environment variables can be set in config.yaml or global_config.yaml with the web_environment key, or ddev config global --web-environment=ENV1=someval,ENV2=someotherval
• Drupal8/9 no longer has a custom "working_dir", meaning that ddev ssh and ddev exec land in the project root by default, not in the docroot.
• Drupal 8/9 no longer use drush launcher to launch drush, but instead pick up the drush in vendor/bin (which must be site-installed)

Caveats

• For Drupal8+ users drush launcher and drush8 are no longer provided. This means that your project must have a site-installed/composer-installed drush (ddev composer require drush/drush). If your installation does not have drush in vendor/bin/drush (which is the default) it may not be in the $PATH and you may need to use one of several techniques to add it to the in-web-container $PATH.
• For Drupal6/7 users, "drush" is now just drush8, not "drush launcher".

Instructions and Workarounds for Apple M1

1. Install the Docker Tech Preview 7.
2. Use a terminal app that is not running. under Rosetta 2. So for example, if using iTerm, the "get info" checkbox should NOT say "Open using Rosetta".
3. Install with Apple Silicon Homebrew (in /opt/homebrew) or using the install_ddev.sh v1.17.0-alpha3 script as above.
4. Check to make sure you got the arm64 version of ddev. file or file /usr/local/bin/ddev should show "/usr/local/bin/ddev: Mach-O 64-bit executable arm64". If it shows amd64, you have the wrong version of ddev.
5. ddev --version should show the right version
6. The Docker Tech Preview 7 does not yet provide the hostname "host.docker.internal" inside the container. On my machine it's 192.168.64.1, and may be the same on yours. You can find out what it is (temporary hack) by docker run -it --rm alpine nslookup junker99.com - the "Server" reported in the failed lookup seems to be host.docker.internal. If yours is not 192.168.64.1, then put what yours is into ~/.ddev/global_config.yaml host_docker_internal: xxx.xxx.xxx.xxx
7. Once that works, you should be able to debug with an IDE like PHPStorm (and PHPStorm now has a full Apple Silicon build
8. To get NFS going, there seems to be a difference in networking. Take the IP you found for host.docker.internal and add one and add it to /etc/exports in addition to "localhost". Mine ended up like this:

/Users/rfay -alldirs -mapall=501:20 localhost
/Users/rfay -alldirs -mapall=501:20 192.168.64.2

I was able to figure this out by running Console.app and searching for nfsd and watching for the failure IP address when I ran ddev debug nfsmount.

I'm happy to help you debug this, so ping me (rfay) on slack, or any other support venue

Commits since v1.16.5

10b71d9b6 Add Blackfire agent and full support (#2448)
17ee510a2 Hardened webserver needs to allow /usr/local/bin update, fixes #2725 (#2743)
5427087df Use default_server in nginx configs instead of server_name _, fixes #2729 (#2731)
7a7e4a39c Stop setting working_dir to docroot in Drupal8+, fixes #2534 (#2734)
d73268c43 Add ddev config --auto, fixes #1096 (#2733)
1d9931f8b Allow setting web environment in config.yaml, fixes #871 (#2742)
d374ae91f Give an error on duplicate snapshot anme, fixes #2515 (#2739)
51ede53c7 Improve snapshot restore with --latest, prompting, move to ddev snapshot restore, fixes #1886, fixes #1163 (#2724)
a7cb1488d Use GitHub Actions for linux tests, fixes #2604 (#2615)
32db28e66 Do static checking in github action (#2738)
a66f4e677 Spellcheck docs, fixes #2365 (#2735)
0c2af6bf5 add PHP 8.0 to the supported php versions (#2736)
a12c41fe4 Skip TestGetLocalHTTPResponse on Windows (#2732)
547e10fb2 [docs] Update maintained badge on README (#2728)
a1c1f5d97 Remove duplicate menu entry for shell autocompletion in docs (#2726)
70df9b2e3 Bump PHP default to php7.4, fixes #2657 (#2716)
dd8369b8b Miscellaneous docs fixes (#2695) [skip ci][ci skip]
ffd96db2c [docs] Add "Limitations using ddev composer" for #2547 (#2718) [skip ci][ci skip]
0ef1b0ca0 [docs only] TYPO fixes (#2723) [skip ci]
85e656f95 Add --list and --cleanup options to snapshot command, for #1163 (#2701)
67f99f515 Stop using drush launcher, use drush8 for drupal6/7, fixes #2514 (#2720)
900d46495 Experimental support for Apple Silicon M1 (darwin_arm64), fixes #2338 (#2687)
06887036c Update spf/cobra and dependencies for #2702 (#2715)
d1b68e4b8 Bump default mariadb version to 10.3, fixes #2232 (#2717)
b6c6f0679 Double nginx's http2_max_header_size to 32k, fixes #2697 (#2698)
bc1d660bd TestServices has been failing a lot, give solr a little time to come up (#2714)
5491d0c1b Ignore drushrc.php writing when settings disabled (#2684)
2ff4f0b17 Create new HeidiSQL command for Windows and WSL2 (#2679)
d86db92b0 Update cli-usage.md for bedrock (#2699)
5d17f0e5d Allow configuration to fail when a hook execution fails, fixes #2536 (#2652)
4ab01db3c Improve 3rd-party Apache SOLR setup in additional-services.md (#2670) [skip ci][ci skip]
e93110bc3 [tests only, circleci] Use Ubuntu 20.04 for builds, bump cache, build makemsis from source (#2713)
95a6f48d5 auth ssh command had out of date switch in long description (#2711) [skip ci][ci skip]
d8a2e49d9 Use TYPO3 11 for installations by default (#2707) [skip ci][ci skip]

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.). This now works on Apple Silicon Homebrew as well.
• 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.17.2-alpha2

• Apple Silicon (M1 machines) is now fully supported natively, including with Homebrew installation. See Docker workarounds below.
• Nice improvements to the ddev snapshot command by @cmuench - it now has --cleanup and --list flags.
• ddev heidisql command provides a nice database browser on Windows and Windows WSL2 thanks to @andreashager .
• The PHP default for new projects is now PHP 7.4. A few project types (Drupal 6 and Magento 1) override this to use 5.6.
• The MariaDB default for new projects is 10.3.
• You can now configure ddev to fail if a hook task fails with --fail-on-hook-fail thanks to @majamee
• Drush Launcher is no longer used. Drupal 6 and Drupal 7 projects get Drush 8 directly, and Drupal 8 and 9 must have drush site-installed and it will be found in the $PATH.
• Double nginx's http2_max_header_size to 32k in both ddev-router and web container.

Instructions and Workarounds for Apple M1

1. Install the Docker Tech Preview 7.
2. Use a terminal app that is not running. under Rosetta 2. So for example, if using iTerm, the "get info" checkbox should NOT say "Open using Rosetta".
3. Install with Apple Silicon Homebrew (in /opt/homebrew) or using the install_ddev.sh v1.17.0-alpha2 script as above.
4. Check to make sure you got the arm64 version of ddev. file or file /usr/local/bin/ddev should show "/usr/local/bin/ddev: Mach-O 64-bit executable arm64". If it shows amd64, you have the wrong version of ddev.
5. ddev --version should show the right version
6. The Docker Tech Preview 7 does not yet provide the hostname "host.docker.internal" inside the container. On my machine it's 192.168.64.1, and may be the same on yours. You can find out what it is (temporary hack) by docker run -it --rm alpine nslookup junker99.com - the "Server" reported in the failed lookup seems to be host.docker.internal. If yours is not 192.168.64.1, then put what yours is into ~/.ddev/global_config.yaml host_docker_internal: xxx.xxx.xxx.xxx
7. Once that works, you should be able to debug with an IDE like PHPStorm (and PHPStorm now has a full Apple Silicon build
8. To get NFS going, there seems to be a difference in networking. Take the IP you found for host.docker.internal and add one and add it to /etc/exports in addition to "localhost". Mine ended up like this:

/Users/rfay -alldirs -mapall=501:20 localhost
/Users/rfay -alldirs -mapall=501:20 192.168.64.2

I was able to figure this out by running Console.app and searching for nfsd and watching for the failure IP address when I ran ddev debug nfsmount.

I'm happy to help you debug this, so ping me (rfay) on slack, or any other support venue

Commits since v1.16.5

70df9b2e3 Bump PHP default to php7.4, fixes #2657 (#2716)
dd8369b8b Miscellaneous docs fixes (#2695) [skip ci][ci skip]
ffd96db2c [docs] Add "Limitations using ddev composer" for #2547 (#2718) [skip ci][ci skip]
0ef1b0ca0 [docs only] TYPO fixes (#2723) [skip ci]
85e656f95 Add --list and --cleanup options to snapshot command, for #1163 (#2701)
67f99f515 Stop using drush launcher, use drush8 for drupal6/7, fixes #2514 (#2720)
900d46495 Experimental support for Apple Silicon M1 (darwin_arm64), fixes #2338 (#2687)
06887036c Update spf/cobra and dependencies for #2702 (#2715)
d1b68e4b8 Bump default mariadb version to 10.3, fixes #2232 (#2717)
b6c6f0679 Double nginx's http2_max_header_size to 32k, fixes #2697 (#2698)
bc1d660bd TestServices has been failing a lot, give solr a little time to come up (#2714)
5491d0c1b Ignore drushrc.php writing when settings disabled (#2684)
2ff4f0b17 Create new HeidiSQL command for Windows and WSL2 (#2679)
d86db92b0 Update cli-usage.md for bedrock (#2699)
5d17f0e5d Allow configuration to fail when a hook execution fails, fixes #2536 (#2652)
4ab01db3c Improve 3rd-party Apache SOLR setup in additional-services.md (#2670) [skip ci][ci skip]
e93110bc3 [tests only, circleci] Use Ubuntu 20.04 for builds, bump cache, build makemsis from source (#2713)
95a6f48d5 auth ssh command had out of date switch in long description (#2711)
d8a2e49d9 Use TYPO3 11 for installations by default (#2707)

This release is the same as v1.16.4 except for Nginx configuration for TYPO3 and that new TYPO3 projects default to PHP7.4

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: 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.)
• Windows: Use choco upgrade -y ddev to get this one, or download the ddev_windows_installer below.
• Linux and macOS with the install_ddev.sh script: curl -LO https://raw.githubusercontent.com/drud/ddev/master/scripts/install_ddev.sh && bash install_ddev.sh
• 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.16.5

• For the big stuff in v1.16, please read v1.16.0 release notes
• In honor of the TYPO3 v11 release tomorrow, the default PHP version is set to 7.4, because that's the minimum for TYPO3 v11.
• Because TYPO3 v11 needs slightly different nginx configuration for the backend, this provides it, and it works with all supported versions of TYPO3.

Caveats

The configuration for Xdebug 3 is different from Xdebug 2. This doesn't affect the vast majority of people, but if you have custom PHP configuration in your project that changes xdebug.*, it will need to be updated. See the Xdebug 2->3 Upgrade Guide if this is you. Almost nobody needs to touch anything, as ddev already chooses the right config for the right Xdebug version.

Commits since v1.16.4

a9aa54fbc Replace TYPO3 Backend folder nginx redirect in favor of a rewrite (#2709)
9cf1f86be Add TYPO3 11 Backend URL rewriting support and php7.4 default for TYPO3 (#2704)

Note that I gave the wrong link to the install_ddev.sh earlier, has been edited here. So if you used install_ddev.sh to install on Mac M1, please install again with https://raw.githubusercontent.com/drud/ddev/20201210_gotip_arm64/scripts/install_ddev.sh

Installation/Upgrade

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

• Please stop all projects first, this does no harm: ddev poweroff
• macOS Apple Silicon M1: Use install_ddev.sh: curl -sSL -f https://raw.githubusercontent.com/drud/ddev/20201210_gotip_arm64/scripts/install_ddev.sh | bash -s - v1.17.0-alpha1
• 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.). Homebrew does not yet work with arm64, so if you're on Apple Silicon M1
• 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.117.0-alpha1

• Native support for Apple M1 machines!

Instructions and Workarounds for Apple M1

1. Install the Docker Tech Preview 7.
2. Use a terminal app that is not running. under Rosetta 2. So for example, if using iTerm, the "get info" checkbox should NOT say "Open using Rosetta".
3. Install ddev with curl -sSL -f https://raw.githubusercontent.com/drud/ddev/20201210_gotip_arm64/scripts/install_ddev.sh | bash -s - v1.17.0-alpha1
4. Check to make sure you got the arm64 version of ddev. file /usr/local/bin/ddev should show "/usr/local/bin/ddev: Mach-O 64-bit executable arm64". If it shows amd64, you have the wrong version of ddev.
5. ddev --version should show the right version
6. The Docker Tech Preview 7 does not yet provide the hostname "host.docker.internal" inside the container. On my machine it's 192.168.64.1, and may be the same on yours. You can find out what it is (temporary hack) by docker run -it --rm alpine nslookup junker99.com - the "Server" reported in the failed lookup seems to be host.docker.internal. If yours is not 192.168.64.1, then put what yours is into ~/.ddev/global_config.yaml host_docker_internal: xxx.xxx.xxx.xxx
7. Once that works, you should be able to debug with an IDE like PHPStorm
8. To get NFS going, there seems to be a difference in networking. Take the IP you found for host.docker.internal and add one and add it to /etc/exports in addition to "localhost". Mine ended up like this:

/Users/rfay -alldirs -mapall=501:20 localhost
/Users/rfay -alldirs -mapall=501:20 192.168.64.2

I was able to figure this out by running Console.app and searching for nfsd and watching for the failure IP address when I ran ddev debug nfsmount.

I'm happy to help you debug this, so ping me (rfay) on slack, or any other support venue

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: 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.)
• Windows: Use choco upgrade -y ddev to get this one, or download the ddev_windows_installer below.
• Linux and macOS with the install_ddev.sh script: curl -LO https://raw.githubusercontent.com/drud/ddev/master/scripts/install_ddev.sh && bash install_ddev.sh
• 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.16.4

This is the same as v1.16.3, but fixes a bug where people who were using composer_version: "2" couldn't use xdebug. Stranger than fiction.

• For the big stuff in v1.16, please read v1.16.0 release notes
• Xdebug 3.0.1 is included with PHP 7.2/7.3/7.4/8.0! It's much faster and has been getting rave reviews
• PHPMyAdmin (ddev launch -p) now logs into the database as the root user instead of the db user

Why did we need a release for Xdebug 3? It was because the upstream deb.sury.org packages made their planned shift to xdebug 3 for PHP7.2/3/4. Before long, all ddev users who used webserver_extra_packages or did an apt-get install in a custom Dockerfile would have been seeing significant breakage, since the Xdebug config is completely different. And also, of course, people have been looking forward to a faster Xdebug 3.

Caveats

The configuration for Xdebug 3 is different from Xdebug 2. This doesn't affect the vast majority of people, but if you have custom PHP configuration in your project that changes xdebug.*, it will need to be updated. See the Xdebug 2->3 Upgrade Guide if this is you. Almost nobody needs to touch anything, as ddev already chooses the right config for the right Xdebug version.

Commits since v1.16.3

a7d5c6a5e Fix syntax errors in xdebug custom command (#2694)
3e5ff3e46 Use XDEBUG_MODE to disable xdebug in Dockerfile, not disable_xdebug (#2693)
a089dc9ca [docs] Clarify that ddev xdebug should be executed in project directory (#2692) [skip ci][ci skip]

Bug alert: composer_version with xdebug

If you're using composer_version in your .ddev/config.yaml and trying to run ddev xdebug on, it will fail. For now, you can just remove the composer_version line and use the default composer v1 to solve this. It will be fixed in another point release. Thanks to patient bug reporters!

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: 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.)
• Windows: Use choco upgrade -y ddev to get this one, or download the ddev_windows_installer below.
• Linux and macOS with the install_ddev.sh script: curl -LO https://raw.githubusercontent.com/drud/ddev/master/scripts/install_ddev.sh && bash install_ddev.sh
• 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.16.3

• For the big stuff in v1.16, please read v1.16.0 release notes
• Xdebug 3.0.1 is included with PHP 7.2/7.3/7.4/8.0! It's much faster and has been getting rave reviews
• PHPMyAdmin (ddev launch -p) now logs into the database as the root user instead of the db user

Why did we need a release for Xdebug 3? It was because the upstream deb.sury.org packages made their planned shift to xdebug 3 for PHP7.2/3/4. Before long, all ddev users who used webserver_extra_packages or did an apt-get install in a custom Dockerfile would have been seeing significant breakage, since the Xdebug config is completely different. And also, of course, people have been looking forward to a faster Xdebug 3.

Caveats

The configuration for Xdebug 3 is different from Xdebug 2. This doesn't affect the vast majority of people, but if you have custom PHP configuration in your project that changes xdebug.*, it will need to be updated. See the Xdebug 2->3 Upgrade Guide if this is you. Almost nobody needs to touch anything, as ddev already chooses the right config for the right Xdebug version.

Commits since v1.16.2

1e0808da0 Bump upstream php packages to get xdebug 3.0.1 (#2691), fixes #2689
efb5f48af Update database_types.md for mysql 5.7 (#2674) [ci skip][skip ci]
74d164dd3 Use root user for PHPMyAdmin (#2667)
59a40a552 TYPO fixes in cli_usage.md [skip ci][ci skip] (#2678)

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: 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.)
• Windows: Use choco upgrade -y ddev to get this one, or download the ddev_windows_installer below.
• Linux and macOS with the install_ddev.sh script: curl -LO https://raw.githubusercontent.com/drud/ddev/master/scripts/install_ddev.sh && bash install_ddev.sh
• 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.16.2

• For the big stuff in v1.16, please read v1.16.0 release notes
• PHP 8.0.0 stable release!

Bugfixes and docs:

• In some situations a second or third project started would get a "503 no ddev back-end site found".
• In some situations, the instrumentation was not working or did not include the "version" tag

Commits since v1.16.1

fae19f07a Bump image versions to v1.16.2 for release (#2676)
22924573e Docs: Escape asterisks in glob patterns (#2675) [skip ci][ci skip]
c397db6be Less github actions test on nginx.tmpl (#2673)
8381ad5ec Bump webserver to pick up php8.0.0 (#2671)
7dc3139a2 [docs] Update the url for solr-configupdate.sh (#2672) [skip ci][ci skip]
a7172b79e Improve ddev-router nginx config so it can be used in github actions (#2666)
4e05fc1be Docs: Add a little extra info on snapshot deletion [skip ci][ci skip] (#2661)
5b2ee264e Minor docs updates (#2664)
24b45750f Fix segment instrumentation reporting, fixes #2662 (#2665)
4778dc4ca Solve problem with unreachable sites due to ddev-router config fail, fixes #2648 (#2663)