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

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