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

67bff55 Provider refactor followups (#2800)
7165d70 [docs] Update OSX install step order for clarity. (#2793)
751405a Ongoing docs updates [skip ci][ci skip] (#2781)
b0ba7ff Acquia hosting integration, fixes #2681, fixes #905 (#2796)
edf85ad Remove special host.docker.internal handling for mac M1 (#2790)
37ac5f0 Large snapshot restore shouldn't return until it's done and should show status (#2747)
3c45945 Provider cleanup and completion (#2788)
0fb72e3 Fix minor formatting issue in Additional Project Hostnames documentation (#2789)
6acd654 Re-implement DDEV-Live provider integration (#2784)
67495ed Rework Pantheon integration to use new yaml-based technique (#2782)
3f61198 Adds Drush site:install and uli to D8 and D9 quickstart (#2780)
29078ab Update index.md - link to brew.sh was not correct (#2777) [skip ci][ci skip]
f8a26d2 Platform.sh and generic hosting provider integration, fixes #2384, fixes #2194 (#2763)
78b99e4 Use updated upstream for yarn fix, fixes #2772 (#2775)
41d3f26 Miscellaneous docs fixes [skip ci][ci skip] (#2748)
4a0767a Minor test improvements (tests only) (#2771)
a205053 [docs] Fix typo in step-debugging.md (#2774) [skip ci][ci skip]
5653ef3 Update in-container-configuration.md (#2770)
8c939be Remove magerun from web container as people use composer-installed version (#2768)
5b75fa9 Testcache was wrong for circleci (CircleCI tests only) (#2766)
2fc5203 Use go 1.16-rc1 to build M1 builds (#2764)
0df5360 Remove several circleci jobs as github actions is doing them (#2761)
e68cc34 Improve DDEV configuration validation errors (php_version, mysql_version, etc.) (#2745)
4094078 Turn off buildkit build in ddev start (docker-compose) (#2758)
170cd19 Bring in php8.0 extensions redis and memcached from upstream (#2759)
9db9035 Improve fragile test TestComposeStreams (#2757)
37826a4 MariaDB default didn't get changed to 10.3 for M1 (#2750)
56830ff Remove drush launcher config from web image [skip ci][ci skip] (#2749)
10b71d9 Add Blackfire agent and full support (#2448)
17ee510 Hardened webserver needs to allow /usr/local/bin update, fixes #2725 (#2743)
5427087 Use default_server in nginx configs instead of server_name _, fixes #2729 (#2731)
7a7e4a3 Stop setting working_dir to docroot in Drupal8+, fixes #2534 (#2734)
d73268c Add ddev config --auto, fixes #1096 (#2733)
1d9931f Allow setting web environment in config.yaml, fixes #871 (#2742)
d374ae9 Give an error on duplicate snapshot anme, fixes #2515 (#2739)
51ede53 Improve snapshot restore with --latest, prompting, move to ddev snapshot restore, fixes #1886, fixes #1163 (#2724)
a7cb148 Use GitHub Actions for linux tests, fixes #2604 (#2615)
32db28e Do static checking in github action (#2738)
a66f4e6 Spellcheck docs, fixes #2365 (#2735)
0c2af6b add PHP 8.0 to the supported php versions (#2736) [skip ci][ci skip]
a12c41f Skip TestGetLocalHTTPResponse on Windows (#2732)
547e10f [docs] Update maintained badge on README (#2728)
a1c1f5d Remove duplicate menu entry for shell autocompletion in docs (#2726)
70df9b2 Bump PHP default to php7.4, fixes #2657 (#2716)
dd8369b Miscellaneous docs fixes (#2695) [skip ci][ci skip]
ffd96db [docs] Add "Limitations using ddev composer" for #2547 (#2718) [skip ci][ci skip]
0ef1b0c [docs only] TYPO fixes (#2723) [skip ci]
85e656f Add --list and --cleanup options to snapshot command, for #1163 (#2701)
67f99f5 Stop using drush launcher, use drush8 for drupal6/7, fixes #2514 (#2720)
900d464 Experimental support for Apple Silicon M1 (darwin_arm64), fixes #2338 (#2687)
0688703 Update spf/cobra and dependencies for #2702 (#2715)
d1b68e4 Bump default mariadb version to 10.3, fixes #2232 (#2717)
b6c6f06 Double nginx's http2_max_header_size to 32k, fixes #2697 (#2698)
bc1d660 TestServices has been failing a lot, give solr a little time to come up (#2714)
5491d0c Ignore drushrc.php writing when settings disabled (#2684)
2ff4f0b Create new HeidiSQL command for Windows and WSL2 (#2679)
d86db92 Update cli-usage.md for bedrock (#2699)
5d17f0e Allow configuration to fail when a hook execution fails, fixes #2536 (#2652)
4ab01db Improve 3rd-party Apache SOLR setup in additional-services.md (#2670) [skip ci][ci skip]
e93110b [tests only, circleci] Use Ubuntu 20.04 for builds, bump cache, build makemsis from source (#2713)
95a6f48 auth ssh command had out of date switch in long description (#2711) [skip ci][ci skip]
d8a2e49 Use TYPO3 11 for installations by default (#2707) [skip ci][ci skip]