Installation/Upgrade

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

• macOS Homebrew: brew upgrade ddev
• Linux or macOS via script:
  curl https://raw.githubusercontent.com/drud/ddev/master/install_ddev.sh | bash
• Windows: Download the ddev_windows_installer here.

And anywhere, you can just download the tarball or zipball, un-tar or un-zip it, and place the executable in your path where it belongs.

AFTER UPGRADING DDEV AND BEFORE UPGRADING A PROJECT Please manually pull the necessary images. They somehow don't get pulled in upgrading a project. for image in drud/ddev-webserver:v1.1.0 drud/ddev-dbserver:v1.1.0 drud/ddev-router:v1.1.0 drud/phpmyadmin:v1.1.0; do docker pull $image; done

To upgrade to this release with each existing project, please

1. Temporarily remove any docker-compose.*.yaml customizations you’ve made.
2. Run ddev config in your project directory to update your .ddev/config.yaml
3. After verifying correct operation, edit any docker-compose.*.yaml to change the first line to version: '3.6' and reintroduce it, then ddev start

Key changes in v1.1.0:

• ddev now requires docker 18.06; a serious docker bug in 18.03 caused lots and lots of crashes, so we moved it up to 18.06.
• You can now remove hostnames that ddev has added to /etc/hosts.
  • ddev remove --remove-data removes the hostname(s) associated with the project
  • sudo ddev hostname --remove-inactive will remove from /etc/hosts all hostnames that are not currently active in a ddev project.
• The docker-compose version has been updated to 3.6, so any customized docker-compose.*.yaml files in your project must be updated to read version: '3.6'
• The project database is now stored in a docker volume instead of in the ~/.ddev/<project>/mysql directory. This means that on your first ddev start it will be migrated from the ~/.ddev file into a docker volume. The old ~/.ddev/<project>/mysql will be renamed to ~/.ddev/<project>/mysql.bak.
• Database snapshotting is now available. At any time you can create a snapshot (in mariabackup format) using ddev snapshot or ddev snapshot --name <somename>. That db snapshot can easily be restored later with ddev restore-snapshot <somename>. These are stored in the project's .ddev/db_snapshots directory.
• ddev remove --remove-data now creates a snapshot by default.
• For Drupal users, drush now works on the host for many commands (after you've done a ddev config and ddev start. So, for example, you can run drush sql-cli or drush cr on the host when you need it, rather than using ddev exec or ddev ssh to do it in the web container. This assumes you have drush available on the host of course.
• ddev --import-files now works on TYPO3 and Backdrop.
• ddev now has integration with the Drud hosting service, so ddev config drud-s3 works for users of the Drud hosting service.
• Php-redis was added to web container.

We look forward to hearing your experience and feedback!

Commits

f9acd24 Improve archive extraction path error handling (#1054)
bb06798 Bump container versions to v1.1.0 (#1049)
a6171c0 Make ddev_drush_settings.php actually work on host, fixes #454 (#1036)
4d7d345 Don't use err when it's nil (#1046)
8d570e7 Add staticrequired to pre-push hooks (#1045)
b8c1087 Refactor file imports, fixes #666, fixes #865 (#1037)
d1b592f Add docker installation and testing instructions (#1041)
bce94d2 Change the AdditionalConfiguration.php template to extend the MAIL array instead of overwriting it (#1043)
39aa1a8 drud-s3 provider implementation, fixes #998 (#1005)
54950bd Move database to docker volume instead of in ~/.ddev, fixes #714 (#987)
933fb74 Move static tests to a new Buildkite pipeline (#1034)
fdf6f7a Add rewrite rule to TYPO3 nginx configuration, fixes #1030 (#1032)
6da3770 Add Memcached service configuration file and documentation. (#927)
165ba99 Clean up hostnames when removing project data, closes #831 (#1017)
9f5eca4 Improve buildkite test_containers.sh by not erroring if docker rm/rmi --fail (#1016)
4466584 Fix ddev exec message offered to wp users on import (#1014)
a9ed0c3 Bump ddev-webserver tag to reflect addition of php-redis and fix of for loop (#1021)
2f186c4 Fix Windows mount of .ddev/mysql configuration (Support for Docker 18.06) (#1022)
7461be8 fix whitespace in generated config.yaml (#1018)
ba7f1df Fix for loop that installs php packages (#1020)
f6784fe Install php-redis module in the web container (#1008), for #267
ccaa5d3 Attempt to remove running projects before testing (#1013)
b282a8b Remove Dockerfile.in instances, obsolete now with latest build-tools (#1006)
a4c221a Update dep dependencies to more current versions (#1003)