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.v1.3.0.exe above.

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.

To upgrade to this release with each existing project, please be cautious and:

1. Temporarily remove any docker-compose.*.yaml customizations you’ve made, and any nginx, apache, php or mariadb overrides.
2. Run ddev config in your project directory to update your .ddev/config.yaml
3. After you've verified basic operation, add your customizations back in.

Caveats

This release upgrades MariaDB from 10.1 to 10.2. For most users and most projects, this will happen automatically on first start of a project. However:

• Snapshots from previous versions of ddev cannot be restored with v1.3+. There's an easy workaround explained in the docs
• Databases from versions before v1.1 (bind-mounted, stored in ~/.ddev/<project>/mysql) cannot be migrated to Docker volumes by this version because that process uses snapshots. However, you can migrate with v1.2.0 and then use v1.3; the easiest thing to do with those old ones is to mv ~/.ddev/<project>/mysql ~/.ddev/<project/mysql.saved and then use ddev import-db to load from a sql dump file.
• Before v1.3, containers ran as root for Windows users, now they run as a normal user. This means that if you have hooks (like post-start hooks) in your config.yaml that do things that need extra privileges, you'll have to add "sudo" to them.

Key changes in v1.3.0:

• Apache support now works on Windows and has full test coverage and is no longer experimental. It seems to work quite well.
• MariaDB is upgraded from 10.1 to 10.2. MariaDB 10.2 has a number of advantages including more flexible key lengths. (This does mean that pre-v1.1.0 databases which were bind-mounted in ~/.ddev can no longer be migrated to docker volumes with this release, see caveats above. Also, snapshots from previous releases cannot be restored with this release, in caveats above.)
• Automatic generation of WordPress wp-config.php has been improved and extra guidance provided for WordPress projects. (#1156)
• The webserver container logs format is improved and all key logs are now provided in ddev logs.
• The webserver container now gives significantly more information in its healthcheck information (use docker inspect --format='{{json .State.Health }}' ddev-<project>-web). It also exits when one of its components is unhealthy, so that we all don't spend time debugging a broken container or broken add-on configuration.
• The dbserver container now provides full log information to ddev logs -s db.
• php-imagick, locales, and php*-sqlite3 and sqlite3 packages added to web container. You can now run a project with a sqlite3 database.
• It's now possible to access web/http/https URLs by name (including https) from within the web container. They get routed to the ddev-router, which sends them back to the right place. So curl https://somesite.ddev.local:8443 will work inside the web container for a project configured with https on port 8443. (#1151)
• No php functions are now disabled in the php disable_functions configuration. (#1130)
• Drupal drush commands do not automatically use '-y' when issued inside the web container. They still do when used in exec hooks, so this should not break any exec hooks. (#1120)
• ddev pull now adds flags so you can skip downloading either files or db. See ddev help pull.
• A number of bugfixes, docs fixes, and significant automated testing improvements.

Commits since v1.2.0

bf8eaeaf Inspect mysql version before failing when restoring a snapshot, #1170 (#1176)
c21e612b Bump image versions for v1.3.0 release (#1171)
8feb4630 Validate config before writing .yaml or starting project, resolves #1095 (#1139)
c350d638 Update WordPress settings management, fixes #756, fixes #1156 (#932)
c9e3cb59 Add configuration flags to ddev pull, fixes #405 (#1138)
bdfd80db Validate the project name when it's entered, fixes #514, fixes #86 (#1147)
16d72e4a Explicitly support mariadb upgrade from 10.1 to 10.2 (#1160)
f83954ad Stop warning about non-config files in ddev start, fixes #731 (#1143)
58f80232 Make supervisord exit when key processes die, fixes #1137 (#1142)
d91e1903 Add " around the version parameter and use TYPO3 v9 (docs only) (#1161)
93d0039f Add content tests in TestDdevFullSiteSetup, fixes #677 (#1155)
d5e7b37e Improve TestWebserverType() (#1154)
4486bc30 Emergency fix to logs_test.go for failed master (#1159)
9063a314 Improve reliability of TestDevLogs (in cmd) (#1145)
ad4aa458 Add debugging for intermittent failures on TestDdevRestoreSnapshot (#1149)
1b0e46dc Add php*-sqlite3 to web container (#1150)
3726f955 Improve docker and troubleshooting instructions (docs only) (#1134)
3b72bca0 Provide access to router within web container by hostname, fixes #842 (#1151)
9cda2146 Do not try to start project for a snapshot, fixes #1129 (#1146)
19063c0c Change mysqld to output to stderr, fixes #1136 (#1141)
95eabc0b Unset disable_functions in php config, fixes #1127 (#1130)
e0e5d760 Respect an existing user-managed AdditionalConfiguration.php, fixes #1053 (#1140)
66a6eaea Faster failure on startup if container fails, fixes #1135 (#1144)
a3995583 Add test to make sure we get the webserver we configure, fixes #1094 (#1148)
4940a33f Add rewrites for ssl so apache behaves properly (#1124)
79f2cefa Provide a flag to specify webserver type in ddev config, fixes #1103 (#1132)
07706e4a Upgrade containers (and mariadb to 10.2), fixes #947, fixes #1068 (#1123)
86cdb86f Don't use -y automatically on drush commands, fixes #1118, fixes #455 (#1120)
737033bd Use command instead of which in install script, fixes #1114 (#1119)
54059acb Add php module post-start hook example to docs, fixes #1117 (#1121)
7dec1a24 Docs - change docker and docker-compose req version (#1116)
51ccfc83 Bump build-tools to get golang v1.11 (#1122)
62d15da5 Make apache run properly on Windows, fixes #1109 (#1111)
02111c58 Provide basic apache testing for ddev, for #1094 (explicit apache tests still required) (#1101)
53e4013d sanetestbot should try to mount something (#1110)
285a2b71 Add php-imagick to web container, fixes #949 again (#1113)
b992f6f0 Add locales to web container, fixes #822 (#1106)
304337e1 docker-compose example should use 3.6 for version number (#1107)

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.v1.2.0.exe above.

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.

To upgrade to this release with each existing project, please be cautious and:

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, make sure any docker-compose.*.yaml has the first line changed to version: '3.6', then ddev start

Key changes in v1.2.0:

• Experimental Apache support has been added, but it doesn't yet work on Windows. You can now run with apache-with-php-fpm (apache-fpm) or apache-with-cgi (apache-cgi). Just change your .ddev/config.yaml to use webserver_type: apache-fpm or webserver_type: apache-cgi. (#1007)
• ddev config now has additional config flags: --php-version, --http-port, --https-port, --xdebug-enabled, --additional-hostnames, --additional-fqdns to allow command-line configuration instead of direct editing of the .ddev/config.yaml file. (#1092)
• The upload directory (Drupal public files directory, etc.) can now be specified in config.yaml. (#1093)
• A number of bugfixes, docs fixes, and automated testing improvements.

Commits since v1.1.1

01512b94 Set additional config values with flags, closes #1051 (#1092)
2be98ef2 Apache for ddev, fixes #628 (#1007)
6824e048 Provide a configurable upload dir in config.yaml (#1093)
2ad83d3f Fix format string typing in ddev describe output, closes #1086 (#1090)
267a0c13 Provide value to format string in docroot creation prompt (#1085)
4bd1348f Add db_snapshots dir to generated .gitignore, fixes #1084 (#1086)
3c7ddd30 Include empty array in JSON output when no projects are active, fixes #588 (#1083)
015813ed Relocate the misplaced 'Stopping a project' section and give it text. (#1081)
7cb01a26 Add zip to list of testbot requirements (#1079)
d7de762b Circleci: Go back to older image and install docker ourselves (#1080)
1fddebd4 Offer to create nonexistent docroots on config, closes #1035 (#1048)
a1bf0d06 Minor docs improvements for buildkite agent (#1077)
30a90398 Reintroduce docker-compose upgrade for circleci (#1078)
7a9900b0 Check if image exists locally before forcing a pull (#1075)
9596ee5a Parallelize Circle build (#1076)
1e554381 Increase gometalinter timeout as we're hitting it too often (#1070)
a4a3fb6b Add some debugging so we know which project fails (#1067)
8a825109 Add disk space check on sanetestbot.sh (#1065)

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.

To upgrade to this release from ddev versions <v1.1.0, please do the following with each project:

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

Fixed in v1.1.1:

ddev will now ensure the required images for database migrations are pulled before attempting to migrate a database.

We look forward to hearing your experience and feedback!

Commits

18436c84 Make sure we have a db image before running it (#1058)

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

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

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 Windows installer

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.

To upgrade to this release with an existing project, please run ddev config in your project directory to update your .ddev/config.yaml

Key changes in v1.0.0:

• Improvements of settings file management for Drupal and Backdrop (more below) (#468)
• Support for fully qualified domain names (FQDNs) (#868) - You can now add to your .ddev/config.yaml additional_fqdns: ["mysite.example.com"] and your site will be available at http://mysite.example.com after restart. More in the docs
• Start, stop, and remove multiple (or all) projects at once (#952). You can ddev rm project1 project2 project3 or ddev rm --all; it works with ddev stop as well, and with ddev start for running or stopped projects.
• Much better resilience when a project is running and the host is rebooted or docker is restarted, etc. This used to result in database corruption regularly on nontrivial databases, and seems to be much improved.
• Lots of bug fixes and enhancements across the board for Drupal and TYPO3

Updated Drupal/Backdrop Settings Managment

With this update, we're moving to a better DDEV settings management system by introducing a settings.ddev.php to contain all DDEV-generated settings on Drupal and Backdrop.

On each ddev config, settings.ddev.php is regenerated and settings.php is inspected to ensure it contains a reference to the settings.ddev.php. If it doesn't, a small block of code will be appended to settings.php to include settings.ddev.php. If a .gitignore file doesn't already exist in the settings directory, one will be created to ignore settings.ddev.php.

We look forward to hearing your experience and feedback!

Commits

af85197c Bump container versions to v1.0.0 (#1004)
ebcebdba Improve ddev start/stop/remove help text (#1000)
3aae0cc8 Allow ddev start to accept project name arguments (#1001)
8973bc71 Updated build-tools to 1.6.1(2) (add the @ to main golang build), fix make push (#999)
f3514b56 Improved management of settings files, introduce settings.ddev.php (#990)
05cf6461 Fix nightly_build.mak after container name change (#995)
8d886582 Bump to build-tools 1.6.0 (#993)
4c9feb04 Rename web and db containers (nginx-php-fpm-local=>ddev-webserver, mariadb-local=>ddev-dbserver) (#991)
d24a9b89 test_containers.sh needs to clean up containers it creates, not leave on testbot (#992)
5fd0d9eb Allow arbitrary additional_fqdns, fixes #868 (#988)
cb150bbb Check testbot sanity before continuing with tests (#986)
99f444a5 Ensure write permissions for settings.local.php and services.yml, fixes #983 (#984)
475e81b6 Drupal8 settings improvements, fixes #504, fixes #680 (#940)
882f3d9f Yet another round of battling building and testing containers on Windows (#966)
6ee268e8 Improve handling of missing settings files, fixes #958 (#977)
4e5d0c86 Allow ddev stop/rm to act on multiple/all sites, fixes #952 (#967)
fae2e47f Improve mariadb-local test to work on linux without making un-deletable files (#975)
8f956767 Make web container .my.cnf read-only so mysql will use it, fixes #944 (#955)
e7cc6eb4 Update docs about composer on Windows (#970)
57f8e86d ConfigFileOverrideAction() should only override if no config exists yet, fixes #900 (#964)
3d855f6c Update docs for Windows 10 Home and Enterprise, update min docker versions, fixes #884, fixes #896 (#965)
ccedee37 Fix case of Sequel Pro.app, fixes #969 (#973)
05111dca Add configuration for typo3 mail and errors, default to php 7.2, fixes #924 (#954)
75e91c41 Switch to use mariabackup instead of just copying files for starter db, fixes #748 (#959)
71ae0db4 Only complain about config.yaml version on start if necessary, fixes #957 (#963)
18299a3e Don't use apk cache to reduce image size (#945)
467e7da7 Update release checklist docs (#951)
1995aac2 Remove duplicate config path resolution (#938)

Installation/Upgrade

See the installation instructions 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. Download the windows installer for Windows. And anywhere, including Windows, you can just downloading the tarball or zipball and place the executable in your path where it belongs.

To upgrade to this release with an existing project, please

• ddev config to update your .ddev/config.yaml.

Key changes in v0.20.0:

• Allow users to issue sudo commands in the web container via ddev ssh, ddev exec, and event hooks
• Add the php-memcached extension to the web container
• Add rsync to the web container

Windows 10 Home with Docker Toolbox

• Download and install Docker Toolbox for Windows 10 Home.
• Install ddev using the ddev windows installer in this release.
• Run the Docker Quickstart Terminal and let Docker start
• Use ddev from within the Docker Quickstart Terminal as you normally would

We look forward to hearing your experience and feedback!

Commits

79e7ba34 Allow a user to issue commands with sudo, fixes #918, fixes #919, fixes #920 (#935)
2432cd6a Improve Drupal 6/7/8 file permissions, fixes #715 (#916)
b564efad Add Composer Setup Example for TYPO3 (#929)
156045e7 Improve reliability with a more unique tmpdir and outdir (#914)
374168cd Install php-memcached extension on web container (#923)
6975fa02 Fix broken containers resulting from CRs in scripts (#913)
4e9f3d3b Provide descriptions for Windows installer components, fixes #903 (#904)
da58b5bd Add release checklist (#908)
42b69c85 Add rsync to nginx-php-fpm-local, fixes #867 (#912)
34ce9b7e Add windows 10 docker toolbox testing to buildkite, fixes #705 (#902)
4b248be6 Create typo3conf/ if it doesn't exist, fixes #741 (#906)
51c3c890 Fix Slack channel formatting, add link to ddev releases page. (#901)

Installation/Upgrade

We're recommending Docker Stable v18.03+ at this time instead of Docker Edge. Users of Docker Edge have hit various trippers.

See the installation instructions 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. Download the windows installer for Windows (which includes sudo; If you get a Windows Defender Smartscreen warning "Windows protected your PC", click "More info" and then "Run anyway". We plan to have this signed in the next release to avoid this problem.). And anywhere, including Windows, you can just downloading the tarball or zipball and place the executable in your path where it belongs.

To upgrade to this release with an existing project, please

• ddev config to update your .ddev/config.yaml.

Key changes in v0.19.0:

• Experimental Support for Windows 10 Home with Docker Toolbox. We wanted to make sure that Win 10 Home users could try ddev. See preliminary instructions below.
• Allow environment variables to propagate into php-fpm. This helps TYPO3 users set the TYPO3_CONTEXT environment variable.
• "ddev describe" shows a direct URL which does not pass through ddev-router
• Add .mysql to allowable database extensions for import. (For backup_migrate users)
• This release includes a variety of bug fixes as well.

Windows 10 Home with Docker Toolbox

• Download and install Docker Toolbox for Windows 10 Home.
• Install ddev using the ddev windows installer in this release.
• Run the Docker Quickstart Terminal and let Docker start
• Use ddev from within the Docker Quickstart Terminal as you normally would

We'll look forward to hearing your experience and feedback!

Commits

4ddabc7c Bump container versions to planned v0.19.0 for release (#897)
e30068c6 Remove max_allowed_packet override, fixes #894 (#895)
e5d9c860 Bring in drud/mariadb-local#63 to solve Windows 10 Home problem, fixes #636, fixes #854 (#856)
4fff979c Include direct web container access in GetAllURLs(), resolves #796 (#890)
881ed261 Make mariadb root user work, drop tables before import, fixes #852, fixes #853, fixes #810, fixes #670 (#891)
4c658744 Increase PHP memory_limit, unlimited for cli, fixes composer OOM in nightly build, fixes #850 (#889)
d4c4590f Implement buildkite builds, for #621 (#888)
8140f3d6 [regression fix] Make project uniqueness constraint work again, fixes #136 (#864)
adb0b8ea Add linux deriving host.docker.internal, fixes #843 (#877)
8459a3c3 Fix bash completion filename in CLI docs, fixes #881 (#882)
5b442e62 Safely get global ddev directory, fixes #806 (#878)
2fb3001d Add arg to build xz archive of ddev images, fixes #839 (#875)
94db20d5 Add debugging in build.sh for running sites problem (#876)
796d44e7 Updates support options, adding StackOverflow, fixes #872 (#873)
3ec311c3 Allow environment variables to propagate into php-fpm (#870)
addffd68 Fix conflicting hostname problem by making list unique, fixes #789 (#825)
06267550 Private files must take precedence before static files in nginx config, fixes #847 (#858)
2d3bab3c Increase proxy_read_timeout for ddev-router, fixes #844, fixes #672 (#862)
a88e827b Make ComposeCmd() interactive again, fixes #859 (#861)
a2c1108f Add section about linux packages (#857)
30831573 Fix d8 web update.php, fixes #830 (#838)
02cf3786 Support .mysql files for import along with related files, fixes #812, fixes #516 (#824)
5db41f89 Use new issue templates for ddev (#826)
e36b1f6e Move container code into ddev repo, build containers in nightly, fixes #729, fixes #730, fixes #320 (#828)
fd0f31bc Simplify ContainerWait(), ComposerCmd, EnsureHTTPStatus, fix build, fixes #837 (#845)
306bbb81 Upgrade docker-compose and golang on circleci build (#841)

Installation/Upgrade

We're recommending Docker Stable v18.03+ at this time instead of Docker Edge. Users of Docker Edge have hit various trippers.

See the installation instructions 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. Download the windows installer for Windows (which includes sudo; If you get a Windows Defender Smartscreen warning "Windows protected your PC", click "More info" and then "Run anyway". We plan to have this signed in the next release to avoid this problem.). And anywhere, including Windows, you can just downloading the tarball or zipball and place the executable in your path where it belongs.

To upgrade to this release with an existing project, please

• ddev rm and then ddev config to update your .ddev/config.yaml. (ddev rm doesn't throw away anything; you won't lose your database.)
• Note that your docker-compose.yaml will be recreated on every ddev start as described below.

Key changes in v0.18.0:

• Step debugging (XDebug) is massively simplified. No more setting a host IP address, no more changing the port. See updated docs and quick screencast. Note that this requires Docker 18.03+
• Windows users now have an installer for ddev. Better yet, it includes sudo so you don't have to do that nasty hosts file editing by hand any more.
• Upgrade path:
  • ddev now manages the .ddev/docker-compose.yaml file - it is now created on every ddev start. A backup of the old one is made, but please do not make edits to docker-compose.yaml. The docs explain how to add random docker-compose additions in other files.
  • ddev now versions the config.yaml file, and pesters you if you haven't upgraded the config.yaml to the current ddev version. You update it by just stepping through ddev config without changing anything.
• Nodejs, npm, yarn, and patch are now pre-installed in the web container.
• We have started trying to answer support questions on Stack Overflow. Please tag your questions with "ddev", and help out by answering others' questions. There is a pretty good collection there already.
• This release includes a variety of bug fixes as well.

Commits

0d5841a2 Bump ddev-router image tag to solve problem with header too big (#836)
90cb1944 Remove windows warning about running containers as root, fixes #800 (#803)
8429912b Add windows_install to nightly and tag builds, fix nightly build (#827)
80ec87be Windows installer, fixes #786, fixes #780, fixes #798, fixes #701 (#787)
ba4cfde3 Override docker-compose.yaml on ddev start, fixes #762 (#819)
e8aa172b Make ddev logs work against stopped project/container, fixes #719 (#823)
c86969b0 Stop using container versions in config.yaml, version the APIVersion, fixes #762, fixes #713 (#820)
ef4814f6 Revamp docker-compose file ordering and choosing, fixes #815 (#817)
feb25d92 Clarify urls for accessing solr docker container (#792)
38209b6f Simplify xdebug configuration, fixes #736, fixes #735 (#785)
d2fde7d0 Document adding extra env variables, fixes #757, also #758 (docs only) (#816)
5b525567 Set COLUMNS and LINES in container shell (#804)
996b8c4d [BUGFIX] Trusted hosts pattern (#1) (#808)
1b407e50 Only build xz images on tag build, fixes #801 (#802)
8a644dd2 [BUGFIX] Update TYPO3 Example (#807)
37394e9f Remove com.ddev.container-type from documentation (#791)
6cabb841 Use colors on windows instead of funny characters, fixes #363 (#795)
98bcc815 Add mention of phpMyAdmin and the Sequel Pro command (#793)
78ce3bdc Add Stack Overflow as support mechanism, fixes #702 (#779)
f9a31bb7 Fix docs reference to php-fpm.log (#777)

In addition, the web container was updated to provide nodejs, npm, yarn, and patch.

Installation/Upgrade

As of v0.17.0 we're recommending Docker Stable instead of Docker Edge. Edge was more stable than Stable for a while. Now it's not. Docker Stable v18.03+ is working the best at this point.

See the instructions 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. Or anywhere, including Windows, by just downloading the tarball or zipball and placing the executable in your path where it belongs.

This version contains an experimental Windows installer, ddev_installer.v0.17.0.exe

To upgrade to this release with an existing project, please

• Delete the .ddev/docker-compose.yaml (it will be recreated on start)
• Delete the "webimage" and "dbimage" lines in .ddev/config.yaml (or delete the whole file if you have no customizations)
• Remove any custom nginx configuration (you'll need a new one based on current configs, that includes the php status endpoint). See ddev nginx docs and the ddev web container nginx configs
• ddev rm to shut the project down (you won't lose any database contents)
• ddev config to update the project's image list
• ddev start to recreate the containers.

Key Changes in V0.17.0:

• The additional_hostnames: option in config.yaml now allows for many hostnames (all at *.ddev.local) to be recognized. See docs
• A number of bug fixes and performance enhancements. The most important (but invisible and irrelevant to most people) is that the nginx port inside the web container is moved back to port 80; it was on port 8080 in v0.16.0.

Commits:

73517397 Fix missing port on urls at startup by fixing GetAllURLs() (#775)
f5c1123a Multi-hostname support, fixes #620 (#751)
1a8a4510 Put web container internal port back to port 80 (#770)
2b149411 Add failsafe so we don't blow away the repository when import-files on drupal6 (#766)
9d406f38 Fix docker-compose constraint typo (#771)
2acd7aef Fix database corruption problem on ddev rm (#763)
e4e6da9b Add warning about release notes to install docs (#768)
780cedf1 Remove special linux filesystem instructions, add docker-ce post-install, fixes #754 (#765)
2aff9f2d Make circleci install current stable Docker-ce (#761)

Installation/Upgrade

See the instructions 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. Or anywhere, including Windows, by just downloading the tarball or zipball and placing the executable in your path where it belongs.

To upgrade to this release with an existing project, please

• Delete the .ddev/docker-compose.yaml (it will be recreated on start)
• Delete the "webimage" and "dbimage" lines in .ddev/config.yaml (or delete the whole file if you have no customizations)
• Remove any custom nginx configuration (you'll need a new one based on current configs, that includes the php status endpoint). See ddev nginx docs and the ddev web container nginx configs
• ddev rm to shut the project down (you won't lose any database contents)
• ddev config to update the project's image list
• ddev start to recreate the containers.

Docker Stable and Edge 18.03.* now seem to work OK with this release

In previous releases we had warned not to use some of the then-current Docker releases. The current Stable and Edge channels (18.03) seem to be working now, but those broke both Windows and Linux versions of ddev and this release fixes the problems Docker introduced.

Key Changes in v0.16.0:

• xdebug is disabled by default for performance reasons. Please see docs to see how to enable xdebug explicitly. We have seen 6-10X improvement in performance with this change.
• Fix Windows issue introduced by docker in v18.03 where the ddev-router could not mount the docker socket.
• Project db settings file (Drupal's settings.local.php, TYPO3's AdditionalConfiguration.php) is created on ddev config instead of on ddev import-db.
• Web and db containers now run as the same (unprivileged) user as the ddev user whenever possible, solving a variety of problems, including improving security.
• composer will no longer complain about running as root if it is run as root in the web container.
• Fix problems introduced in recent Docker Stable channel for Linux users (web container could not start).

Commits:

fa5a91ec Always set DDEV_UID/DDEV_GUID to run web container as host uid, fixes #635, fixes #740 (#745)
b58f43ff Documentation updates to address #468, #704, #743 (#752)
b108ac66 Set COMPOSE_CONVERT_WINDOWS_PATHS Windows docker ddev-router failure, fixes #739 (#753)
ed03c1bf Disable xdebug by default for 6x speed improvement fixes #664 (#718)
17f9c51a Note Backdrop's quick start. (#744)
ecb42f8f Create settings file when configuring project, fixes #692 (#693)

Docker Edge recently shipped with a -rc2 docker-compose, which did not pass version comparisons in ddev so was not functional with ddev. The only user-visible change in this release is to solve that problem.

Please read the release notes for v0.15.0 if upgrading.

Installation/Upgrade

See the instructions 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. Or anywhere, including Windows, by just downloading the tarball or zipball and placing the executable in your path where it belongs.

Installation/Upgrade

See the instructions 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. Or anywhere, including Windows, by just downloading the tarball or zipball and placing the executable in your path where it belongs.

Important Issues

To take full advantage of this release with an existing project, please

• Delete the .ddev/docker-compose.yaml (it will be recreated on start)
• Delete the "webimage" and "dbimage" lines in .ddev/config.yaml (or delete the whole file if you have no customizations)
• Use ddev config to update the project's image list
• ddev start to recreate the containers.

Important: Use docker 17.09 or 18.03 until a fix comes out:

As of 9 March 2018, the latest stable docker version (17.12) hangs regularly when using docker-compose and bind-mounted filesystems. The docker issue is https://github.com/moby/moby/issues/35933. As a result, we're using 17.09 or 18.03 (edge) exclusively until this can be solved by the docker project.

Key changes in v0.15.0

• Allow Override of PHP Configuration and mysql/Mariadb configuration
• Improved logging for both web and db containers (ddev logs)
• Remove Restart Configs from Docker Compose Actions
• Database container now comes up much faster, meaning an initial startup for a new project is much faster.
• Automatic docroot detection - during ddev config ddev attempts to automatically detect the project docroot (and does a very good job), thanks @mglaman !
• Solved complaints from mysqldump and drush sql-dump about mysqldump arguments
• Fix composer failure related to pcntl_signal, drud/ddev#710

Commits:

9dd6087a Fix utf8 instructions (#721)
7c008252 Documentation text review (#688)
b05d6554 Allow override of mysql and php configuration, fixes #654 (#707)
1f8c2cb7 Adjusted the TYPO3 quickstart section (#712)
ed3355d4 Change "app" and "application" to "project" in user-facing docs/output, fixes #526 (#686)
90bbed5b Add Config docroot detection, fixes #663 (#678)
1a43eefa Don't remove settings.local.php when removing database, fixes #478 (#695)
fb15507b Document how to upgrade ddev, fixes #699 (#700)
e961cd22 Switch restart to 'no' for all containers, fixes #676 (#708)
9798689c Add ddevapp tests for drupal6, backdrop, TYPO3, fixes #617 Pull on 2018-03-6 #TRIVIALREVIEW (#671)
020912b8 Add info about /Users/rfay/go and our containers (#703)
f750bdb4 Add Linux xdebug instructions, fixes #610 (#685)

Important: Use docker 17.09 until a fix comes out:

As of 27 Feb 2018, the latest stable docker version (17.12) hangs regularly when using docker-compose and bind-mounted filesystems. The docker issue is https://github.com/moby/moby/issues/35933. As a result, we're using 17.09 exclusively until this can be solved upstream.

Key changes:

• Fixed broken config.yaml hook output regression #657
• Changed from one-size-fits-all nginx configuration to one nginx config per CMS #669
• Fixed missing $settings['hash_salt'] for Drupal 8 #656
• TYPO3 improved AdditionalConfiguration.php #673
• Misc docs and other bugfixes
• For the first time we're publishing a packaged version of the docker images for this release. You can download ddev_docker_images.tar.gz and install them immediately with gzip -dc ddev_docker_images.tar.gz | docker load. This makes the first start of a new project significantly faster, as docker doesn't have to download the images one-at-a-time. However, it makes no functional difference, and it's not required to download the image tarball.

Commits:

9ea5109a Bump version to bring in separate-nginx-per-cms, fixes #648 (#669)
cda277f6 [BUGFIX] fix typo in install instruction output for bash completion (#675)
8b164ae6 Add output from exec hooks, fixes #606 (#657)
6ecd1ada Add docker images to artifacts for #501 (#662)
880f73c2 Make drupal 7 and drupal 8 settings distinct, recover settings[hash_salt], fixes #647 (#656)
f319869b Generate AdditionalConfiguration.php compatible with TYPO3 8.7 (#673)
3604278c Updated build-tools to 1.5.5 (golang 1.10) (#667)
f9765b43 Update Gopkg.toml with prune, update vendor based on that, fixes #649 (#661)
0c8416bc Upgrade golang to 1.10 for testing, docker-compose 1.19 (#665)

Important: Use docker 17.09 until a fix comes out:

As of 13 Feb 2018, the latest stable docker version (17.12) hangs regularly when using docker-compose and bind-mounted filesystems. The docker issue is https://github.com/moby/moby/issues/35933. As a result, we're using 17.09 exclusively until this can be solved upstream. Note that the "edge" version 18.02 may have the new fix in it.

Updates in v0.13.1

This minor release mostly just updates the web container now that php7.2 and xdebug play together:

• Add php 7.2 as an option, so we now support 5.6, 7.0, 7.1, and 7.2, all with xdebug.
• Add drupal-console launcher in /usr/local/bin/drupal
• Add the backdrop drush extensions, but only for backdrop projects.
• Minor fix for pantheon API parsing for some users.

Warnings about existing projects from before v0.12.0

• Existing projects should work fine with their existing .ddev/config.yaml. However, if you have a saved database for a project and you remove the config.yaml and/or update the usage of the db container, it may cause incompatibility with the upgraded container. In this case, do a ddev rm --remove-data and then start and re-import the database. (In the best case, export your database, then remove the .ddev folder, then use ddev config again to configure it, then use ddev import-db to reimport your project's database. Full details are in https://github.com/drud/ddev/issues/615 (If you see the message "Failed to start yoursite: db service container ddev-yoursite-db: detected container restart; invalid configuration or container", that probably means you need to remove and restart.)
• To use the new config.yaml directives like router_http_port, router_https_port, the .ddev/docker-compose.yml must be deleted and the project restarted.

For both of these situations, the foolproof technique to upgrading a project is:

1. Save a database dump.
2. Use ddev rm --remove-data to remove the site's database storage.
3. Look at your .ddev/config.yaml for modifications (like post-import-db steps) and at your docker-compose.yml for modifications (unusual).
4. If there are no modifications, then remove your .ddev folder
5. Configure the site again using ddev config
6. Use ddev start to start it up
7. Use ddev import-db to reimport your saved database dump

Note that you do not have to update your project's .ddev folder at all, so no action is actually required unless you need new features like the ability to change the port the router listens on. And of course, you don't need to save away and reimport your database if that's not important.

Changes:

f3d1d3cd (HEAD, tag: v0.13.1) PHP7.2 and Drush backdrop support, fixes backdrop drush support (#651)
ab468f80 Remove go-pantheon parsing of invited_by_id because it breaks and we don't use it, fixes #645

Important: Use docker 17.09 until a fix comes out:

As of 13 Feb 2018, the latest stable docker version (17.12) hangs regularly when using docker-compose and bind-mounted filesystems. The docker issue is https://github.com/moby/moby/issues/35933. As a result, we're using 17.09 exclusively until this can be solved upstream. Note that the "edge" version 18.02 may have the new fix in it.

Backdrop support!

v0.13.0 adds initial support for the Backdrop CMS, a Drupal fork. Drush in the web container is not yet supported but is a high priority. See the Backdrop quickstart.

Important: Use docker 17.09 until a fix comes out:

As of 30 January 2018, the latest docker versions (17.12 and 18.01) appear to hang regularly when using docker-compose and bind-mounted filesystems. The docker issue is https://github.com/moby/moby/issues/35933. As a result, we're using 17.09 exclusively until this can be solved upstream.

Major changes:

• Explicit support for TYPO3 and Drupal 6 (to go with Drupal 7/8 and Wordpress, Backdrop coming soon)
• It's now possible to change the ports the router listens on to avoid conflicts with other software. (ddev can use port 8000 and 8443 instead of 80 and 443, for example)
• The database container now uses MariaDB 10.1, an upgrade from using mysql 5.5. See below under "Warnings" to see if this affects your existing projects. It does not affect new projects.

Minor changes:

• Project PHP version information added to ddev describe
• Documentation improvements

Warnings:

• Existing projects should work fine with their existing .ddev/config.yaml. However, if you have a saved database for a project and you remove the config.yaml and/or update the usage of the db container, it may cause incompatibility with the upgraded container. In this case, do a ddev rm --remove-data and then start and re-import the database. (In the best case, export your database, then remove the .ddev folder, then use ddev config again to configure it, then use ddev import-db to reimport your project's database. Full details are in https://github.com/drud/ddev/issues/615 (If you see the message "Failed to start yoursite: db service container ddev-yoursite-db: detected container restart; invalid configuration or container", that probably means you need to remove and restart.)
• To use the new config.yaml directives like router_http_port, router_https_port, the .ddev/docker-compose.yml must be deleted and the project restarted.

For both of these situations, the foolproof technique to upgrading a project is:

1. Save a database dump.
2. Use ddev rm --remove-data to remove the site's database storage.
3. Look at your .ddev/config.yaml for modifications (like post-import-db steps) and at your docker-compose.yml for modifications (unusual).
4. If there are no modifications, then remove your .ddev folder
5. Configure the site again using ddev config
6. Use ddev start to start it up
7. Use ddev import-db to reimport your saved database dump

Note that you do not have to update your project's .ddev folder at all, so no action is actually required unless you need new features like the ability to change the port the router listens on. And of course, you don't need to save away and reimport your database if that's not important.

Full changelog

a5789e96 Improve json output of hostname command to give explicit results (#626)
839a9cfd Regression fix: Improve --show-config-location (#625)
7b11c04d Support router_http_port and router_https_port in config.yaml, fixes #481 (#622)
0a65d771 Updated build-tools to 1.5.3 (#624)
a55178d7 Typo3 support for ddev, fixes #570 (#613)
7dc9dc2e Make ddev config work with args when no --apptype provided, fixes #616 (#618)
071decfa Bump DBTag for mariadb startup fix (#614)
c3906229 Fix nightly build by removing clashing circle config stanza (#612)
0d753734 Use alpine-based mariadb container, fixes #488 (#581)
12d7137f Improve JSON output from ddev version (#596)
de3d471e Add support for drupal6 (#595)
05ee2b71 Improve regexp so "." in regex includes newline in test (#602)
1a9f0759 Fix exec-host docs (#605)
1cfdd089 Update docs for remove (and project/site) fixes #599, for #526 (#600)
da314082 chore: Capitalized WordPress (#598)
fba0615f Add PHP version information to ddev describe (#592)
60f9d89b Fix TestListWithoutDir problem on Darwin (#593)

V0.11.0 is mostly a refactoring release, but these changes were made:

• You can now specify a php version (5.6, 7.0, or 7.1) in your project's .ddev/config.yaml. Note that if you have an existing project, you need to delete the .ddev/docker-compose.yml (so it can be recreated) for this to work. The default is php 7.1. Syntax in the .ddev/config.yaml is php_version: "7.0" for example.
• The "domain", currently always "ddev.local" is shown in ddev version

As always, we love to hear your suggestions, bugs, troubles, and even kudos, in the issue queue here, in the Drupal #ddev slack channel, or any other way you want to find us.

Commits/PRs:
9e62e336 (HEAD, upstream/master) Update maintained badge to 2018 (#591)
49e3c6a8 (cweagans/master) DDEV 251: readme and documentation updates (#587)
2f7eb6df Add postImportDBAction capability to apptype matrix (#589)
c41d6495 Add generic apptype detection using apptype approach in #574 (#585)
b2db5b66 Add --continuous for ddev ui (#576)
1e8ec827 Update to support DDEV_PHP_VERSION in config and defaults (#554)
5e015d24 Generic multi-apptype support, for #535 (#574)
2e5fcee4 (tag: top_cms_is_based_on) Remove special windows handling for docker-compose.exe since it has a typo anyway (#582)
89988f3f Semantic Versioning in readthedocs, for drud/ddev #352 (#584)
7c8e1981 Improve comments and signature on 'tail' options in ddev logs testing (#580)
b46e403a Surf build.sh needs to update any images that may be cached (#578)
e5c368d2 Refactor all config into the ddevapp, fixes #458 (#569)
d8ad513c Add the ddev domain to the output of ddev version (#566)
9cf49003 Refactor/remove platform plugin interface, for #458 (#561)
3d2451af Add automation of nightly build using CircleCi scheduling instead of api (#562)
06ef6831 Update circle machine image for later docker (#563)
b64058ec Don't report errors from ComposeNoCapture (#556)
f1106f3a Bump nginx-php-fpm-local version to v0.8.2 (#553)
3e98cb78 Check for docker-compose at install and run time, fixes #491 (#549)
863ac8da Use single quotes instead of backticks for user-facing messages (#550)
d1a65a6b Improve macOS surf install instructions (#544)

• #522 Added support for https local sites (self-signed certificate)
• Default database creation to utf8mb4
• Option to output json for all commands (for ddev-ui)
• Various bug fixes and minor improvements

All changes since v0.9.3:
99a18b5e Fix missed shortroot conversion in test, broke windows test only somehow (#546)
a157dd8f Fix discovered json output flaws (#543)
97d03df8 adds support for https in ddev router (#522)
a1bdba92 Add complexity rating to issue template (#539)
bdfbf02b ddev rm, describe, and stop are now reliable even when a site directory is missing; fixes #459 (#460)
8937579b Bump db container version for utf8mb4 (#538)
f794ed9c (master, 20171116_circleci_update, 20171113_understand_rm_failure) Fix failed override of provider introduced in #495 (#520)
d27e94a9 Fix panics on ddev list and ddev start (with no config), fixes #521 (#533)
d7b5745c API/json implementation and interaction with ddev, fixes #477 (#499)
b9349cc9 re-workaround readthedocs broken search (#531)
09a2b8f6 workaround for readthedocs broken search rtfd/readthedocs.org#1088 (#530)
d500dab8 Basic port-test capabilities before trying to bring up router, fixes #126, fixes #393 (#483)
9c085b25 Removed 'Experimental Support' because we have adequate test coverage and instructions for Win10Pro (#519)
4ca6d38a Allow command-line arguments for "ddev config", fixes #476 (#495)
8bf72daa Remove obsolete submodules from nightly build (#509)
fd5b699d use official d8 release for testing (#503)

The most notable change with this release is the update of our web container image, which received a number of updates:

• Upgrade PHP to 7.1
• Upgrade NGINX to 1.12.1
• Upgrade Drush to 8.1.15
• Upgrade WP-CLI to 1.3.0
• Upgrade Mailhog to 1.0.0

Commits:

84e1281a update web image and test for php 7.1, fixes #330 (#507)
fb27badb Quickstart docs for existing Wordpress and Drupal sites. Fixes #433. (#482)
675593ef fix installer script colors, remove tput dep (#498), fixes #490
4b166c0c Fix bug where provider was always assumed, fixes #437 (#497)
76543de4 Change usage to macOS Sierra and higher, fixes #480 (#492)

This release is mostly to fix a problem some users have encountered with checking github for new releases too often, which results in an error message from the github API. There are only very minor user-facing changes besides that. Upgrading is recommended to all users.

Commits:

c860c127 (HEAD, tag: v0.9.2, upstream/master) Refresh updatefile on each check even if we're not updating, fixes #479 (#489)
855a64c8 Use drupal-project instead of a bare Drupal site (#461)
fe1a8c6a Revert to using Circleci's docker version, upgrade docker-compose, fixes #471 (#473)
42c2ca50 Add homebrew install instructions to index.md for readthedocs. (#470)
a0ee2e90 Use dep to manage dependencies (#465)
22498e2e Implement new gometalinter capabilities and take care of warnings about them (#464)
fe18da2e Minor spelling corrections. (#462)
d47345f6 "ddev list" shows sites based on container, even if directory is removed: fix for #374 (#444)
95e01577 Make installation via homebrew the default instructions for macOS (#457)
c676f383 Minor updates to github templates for clarity (#453)
a7d050fd Forgot to update the testing-local version of golang (#447)
1277b297 Upgrade build to golang 1.9.0 (#446)