Installation/Upgrade
See the installation instructions for details, but it's easy:
- Please stop all projects first, this does no harm:
ddev stop --all --stop-ssh-agent
- macOS Homebrew and Linux Linuxbrew: To get this one you need to be on the ddev-edge channel:
brew tap drud/ddev-edge
or justbrew install drud/ddev-edge/ddev
) - Windows: Download the installer.
- And anywhere, you can just download the tarball or zipball, untar or unzip it, and place the executable in your path where it belongs.
- You'll want to do a
ddev config && ddev start
for each project just to update the config file so it has the current APIVersion in it. Otherwise ddev will keep pestering you to do that.
Caveats
- Please avoid upgrading to macOS Catalina, as mkcert is not ready for it.
- This version of ddev bundles the latest PHP7.2 and 7.3 versions (7.2.20 and 7.3.7). There have been some reports of Symfony/Doctrine incompatibilities/bugs with those versions.
Key changes in v1.10.0-alpha4
- ddev now has a "poweroff" command.
ddev poweroff
is quick way to stop all ddev containers. It's the same asddev stop -a --stop-ssh-agent
but a lot easier to remember. A tip of the hat to our friends at lando. - You can now add files to the web container's home directory by adding them to
.ddev/homeadditions
, so files like~/.gitconfig
and~/.ssh/config
can be added, or bash aliases, etc. See docs.
Smaller changes in v1.10.0-alpha4
ddev ssh
now uses a bash login shell, meaning that .profile will run as most people would expect.- Improved behavior with TYPO3 installation using https, thanks to @jonaseberle .
- A bug from v1.10.0-alpha3 was fixed; it brought unexpected files from a project "assets" directory into ~/.ddev. Thanks to @mfrieling for discovering and reporting.
Smaller Changes in v1.10.0-alpha3
- The ddev binaries on macOS and Windows are now signed.
- Better URL presentation in
ddev start
andddev describe
(anddescribe
gives more information) ddev restart proj1 proj2
andddev restart -a
now workddev ssh <project>
now works- Improved timezone documentation in both config.yaml and ddev.readthedocs.io
- Example custom command for
ddev mysqldump
Key changes in v1.10.0-alpha1
- Custom commands! You can now create custom ddev commands using a simple bash script. See the docs for how to do it.
- There's a real user created for you inside the web and db containers, with your username and userid. And the containers have an explanatory hostname, like
<projectname>-web
. This also makes things easier for the times people install a package that creates a user or group, there's plenty of room for that to happen now. Those of you who useddev ssh
andddev exec
: We'd love to hear your feedback about this. - The first official bash custom command is the
mysql
command, so you can nowddev mysql
to work directly with the mysql client in the db container, and you can pipe into it, etc.
Smaller Changes in v1.10.0-alpha1
- ddev import-db now accepts stdin, so you can
gzip -dc yourfile.sql.gz | mysql db
to load a database. Of course, you can also do that with the newddev mysql
command. ddev exec
is now happy to accept input from stdin.Thanks @dasjoe!- PHPMyAdmin and web ports are no longer shared with the local network. This was a bit of a security risk. If you were allowing your coworkers to access your project across the network and depended on this, try
ddev share
. Or you can override the settings with a docker-compose.letthemin.yaml - Healthcheck improvements should improve battery life and CPU usage. A fair number of people had noticed that all the containers were waking up every few seconds for no particular reason. Now the healthcheck is every minute or so.
ddev import-db
no longer automatically drops all tables in the database. Instead, your dumpfile should empty tables as necessary (or you can use another technique likeddev exec drush sql-drop -y
Thanks!
There was loads of community collaboration in this release, we so appreciate your participation!
- @jonaseberle did a major PR to make TYPO3 installation with https work correctly... after doing a PR to make TYPO3 work right in the same situation!
- @klonos kept the Backdrop drush extensions up-to-date, thanks!
- @dasjoe updated ddev exec to make it properly accept input from stdin.
We love your PRs and issues, keep them coming! You're the reason this project works.
Commits since v1.10.0-alpha3
2ad94a0 Get rid of TYPO3 trustedHostsPattern warning, fixes #1739 (#1741)
2948e7e Make sure EOL at end of file is there in config.yaml, fixes #1740 (#1742)
6b76de8 Allow home directory additions in web container, fixes #926, fixes #1459 (#1728)
669e3fd Update typo3 quickstart with warning about https url (#1732)
f70c82a TYPO3 AdditionalConfiguration.php: fix warning in array_merge() (#1735)
17b3d2b Add ddev poweroff command, fixes #1588 (#1733)
21b4cd0 Make ddev ssh use a bash login shell (#1730)
71fc560 Remove Sentry 'Usage' sends (#1729)
40c3144 Remove verbiage about default docker images (docs only) (#1725)