Installation

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

• macOS: brew install ddev/ddev/ddev or just brew upgrade ddev.
• Linux: Use apt install ddev or apt upgrade ddev see apt/yum installation
• Windows and WSL2: Download the ddev_windows_amd64_installer.v1.24.7.exe; you can run it for install or upgrade.
• Consider ddev delete images or ddev delete images --all after upgrading to free up disk space used by previous Docker image versions. This does no harm.
• Consider ddev config --auto to update your projects to current configuration.

Highlights

• Windows Installer handling Traditional Windows, WSL2/Docker CE, and Docker/Rancher Desktop. Read more, with video
• Support added for MariaDB 11.8 LTS, ddev config --database=mariadb:11.8
• New ddev-hostname binary for hosts editing (with improved elevation/escalation technique) (gsudo is no longer required on Windows, and ddev.exe installation is no longer required on Windows WSL2. Read more
• New Linux ddev-wsl2 package is built specifically for WSL2 and includes Windows-side binaries, so separate upgrading of Windows-side binaries is not needed
• WSL2 Mirrored Mode now has automated testing
• New minimally supported Docker providers:
  • Docker Desktop for Linux - has had limited manual testing only; prefer the documented docker-ce installation
  • Rancher Desktop for Windows - has had limited manual testing only; currently the only open-source provider on traditional Windows
• It's recommended to run ddev delete images after the upgrade

Breaking Changes

• If you rely on ## Flags annotation in custom commands, there is a change: unknown flags will no longer be parsed and will cause Error: unknown flag or Error: unknown shorthand flag. Either define all possible flags explicitly or remove the ## Flags annotation.

Features

• Enhanced Docker images cleanup in ddev delete images, ddev delete, ddev clean
• Shell completion support for flags in ddev config and ddev config global
• New DDEV_USER environment variable for use in custom .ddev/docker-compose.*.yaml files
• ddev launch in WSL2 works without installing xdg-utils (which can be safely removed on existing installations after update)
• Support for NO_COLOR variable, see Using NO_COLOR Inside Containers
• Return real exit code from ddev exec and add quiet -q flag to it, thanks to @andreashager

Bug Fixes

• Fix ddev composer create-project to accept stdin
• Remove unused Node.js version cache in ddev-global-cache Docker volume, thanks to @lozcalver
• Add overrides from all .ddev/config.*.yaml files to .DdevProjectConfig (used in Go templates, see example)
• Make --json-output / -j work as expected for debug/verbose output.
• Fix issue where the db container couldn't restart alone when extra config was present in .ddev/mysql/*.cnf, thanks to @das-peter

Minor Updates

• PHP 8.3.23 and 8.4.10
• Xdebug 3.4.4
• docker-compose v2.38.2
• Update debian-archive-keyring for EOL database images (mysql:5.5, mysql:5.6, postgres:9, postgres:10, postgres:11)
• Display user defined router-compose.*.yaml and ssh-auth-compose.*.yaml during ddev start
• Align Craft CMS quickstart with official docs, thanks to @AugustMiller
• Normalize default values in ddev help config and ddev help config global

What's Changed

• build: apply more staticcheck rules from golangci-lint, fixes #7155 by @stasadev in #7317
• docs: trailing whitespace on template by @hanoii in #7321
• build: update debian-archive-keyring for archived debian repos, fixes #7320 by @stasadev in #7324
• docs: use latest markdownlint, update "here" links by @stasadev in #7327
• feat: prune orphaned Node.js versions after install, fixes #7325 by @lozcalver in #7326
• docs: add tip on initial PhpStorm plugin setup by @stasadev in #7331
• refactor: improve message about missing docroot on ddev start by @stasadev in #7332
• docs: clarify instructions for using PhpStorm inside WSL2 by @pbowyer in #7333
• fix: make ddev composer create-project work with stdin by @stasadev in #7336
• docs: update vendor/bin/composer examples, for #6772 by @stasadev in #7344
• docs: align Craft CMS quickstart with official documentation by @AugustMiller in #7323
• docs: update ngrok link by @tyler36 in #7359
• feat: display user-defined router-compose.*.yaml on ddev start by @stasadev in #7355
• test: update check for starter page in Silverstripe CMS by @stasadev in #7368
• fix: Allow Docker Desktop for Linux (DDFL) but warn about it, fixes #7307 by @rfay in #7363
• build: Update google/go-github to v72, remove obsolete dependencies, replaces #7369 by @rfay in #7370
• feat: add DDEV_USER env var for web container user, sync env tests with docs by @stasadev in #7365
• feat: Support new LTS MariaDB 11.8 by @rfay in #6983
• refactor: clarify comment on legacy PostgreSQL, for #7324 by @stasadev in #7382
• build: use yaml/go-yaml instead of unmaintained yaml.v3, fixes #7280 by @rfay in #7381
• feat: add shell completion for ddev config and ddev config global by @stasadev in #7356
• docs: improve xhgui documention, fixes #7376 by @michaellenahan in #7377
• fix: Remove COMPOSE_CONVERT_WINDOWS_PATHS to make Rancher Desktop (Windows) work by @rfay in #7375
• build: bump ddev-webserver and ddev-traefik-router, for #7282 by @stasadev in #7378
• test: Add testing for wsl2 mirrored networking, fixes #7379 by @rfay in #7380
• test: remove TestCmdAddon leftovers in ~/.ddev by @stasadev in #7387
• feat: display user-defined ssh-auth-compose.*.yaml on ddev start by @stasadev in #7388
• feat: improve images cleanup in ddev delete images, ddev delete, ddev clean, fixes #5073, fixes #7201 by @stasadev in #7151
• refactor: normalize defaults in ddev help config and ddev help config global, update docs by @stasadev in #7386
• build: remove go-homedir, fixes #7366 by @rfay in #7390
• test: use main for setup-homebrew action instead of master by @chenrui333 in #7395
• build: upgrade mapstructure to v2 by @dolmen in #7396
• test: use bats-core/bats-core homebrew tap instead of kaos by @rfay in #7405
• fix: treat argument as literal in ddevcd despite leading dash by @stasadev in #7401
• fix: make DdevProjectConfig include overrides, fixes #7154 by @stasadev in #7397
• feat: Improve elevation/escalation for hosts editing, including WSL2, fixes #6440, fixes #5324 by @rfay in #7392
• test: Pin umbrelladocs/[email protected] temporarily to sort out failures [skip buildkite] by @rfay in #7411
• docs: Improve windows install docs by @rfay in #7410
• fix: make xdg-utils optional, use explorer.exe on WSL2 [skip buildkite] by @rfay in #7402
• test: Ignore existing golangci-lint/revive package complaints by @rfay in #7415
• ci: use skip-package-name-checks, pin golangci-lint to v2.2.1, remove only-new-issues, for #7415 by @stasadev in #7416
• build: bump umbrelladocs/action-linkspector from 1.2.5 to 1.3.5 by @dependabot[bot] in #7417
• fix: route all logging through output to respect --json-output by @stasadev in #7403
• docs: add blog and add-on registry to navigation by @stasadev in #7427
• build: Use new cooldown to slow dependabot updates [skip ci] by @rfay in #7425
• feat: add NO_COLOR variable support, fixes #7058 by @stasadev in #7419
• refactor: centralize table style configuration by @stasadev in #7434
• fix: use output.UserOut for JSON output, retry on invalid input in interactive ddev config, for #7403 by @stasadev in #7433
• build: drop direct dependency on github.com/pkg/errors by @stasadev in #7432
• feat: add JSON output to ddev -v by @stasadev in #7431
• refactor: move ddevapp.RenderHomeRootedDir to fileutil.ShortHomeJoin by @stasadev in #7430
• docs: add Terminus downgrade tips, fixes #7352 by @bserem in #7353
• feat: return real exit code from ddev exec and add quiet flag to it, fixes #3518 by @andreashager in #7385
• fix: Include ddev-hostname in main build zipballs, fixes #7420 by @rfay in #7443
• feat: Windows Native and WSL2 GUI installer by @rfay in #7404
• build: bump github.com/spf13/cobra to latest commit, fixes #7361 by @stasadev in #7445
• fix: avoid mutating input slice in cmd.prettyCmd() by @stasadev in #7448
• fix: remove unneeded ddev-hostname dependencies to reduce size, fixes #7408, fixes #7444 by @stasadev in #7446
• fix: Improve Windows installer behavior (actually exit on errors) by @rfay in #7452
• docs: add info about proxy for Docker client, fixes #7412 by @stasadev in #7454
• docs: How to use Xdebug with Composer for plugin development by @obriat in #7423
• fix: show errors for custom commands when flags are parsed, fixes #7409 by @stasadev in #7451
• build: Add a ddev-wsl2 package especially for ddev-hostname.exe, fixes #7428 by @rfay in #7449
• fix: temporarily allow write to /etc/mysql/conf.d/* for db container restart, fixes #7457 by @das-peter in #7458
• test: do tests of windows installer, fixes #7440 by @rfay in #7459
• fix: Windows installer shouldn't be so aggressive in removing CAROOT by @rfay in #7461
• build: bump images to v1.24.7 for release, docker-compose v2.38.2 (COMPOSE_BAKE=false), fixes #7383 by @stasadev in #7456
• docs: add .wslconfig example for mirrored networking mode in WSL2 by @stasadev in #7463
• docs: minor update to manual ddev instructions and use apt-get by @rfay in #7465

New Contributors

• @lozcalver made their first contribution in #7326
• @chenrui333 made their first contribution in #7395
• @dolmen made their first contribution in #7396
• @obriat made their first contribution in #7423
• @das-peter made their first contribution in #7458

Full Changelog: v1.24.6...v1.24.7