DDEV Files

Installation

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

• macOS: brew install ddev/ddev/ddev or just brew upgrade ddev.
• Linux: Use sudo apt-get update && sudo apt-get install ddev, see apt/yum installation
• Windows and WSL2: Download the Windows Installer; you can run it for install or upgrade. ⚠️ Traditional Windows users (not WSL2): If needed, the installer will prompt you to uninstall the previous system-wide installation to avoid conflicts with the new per-user installation.
• 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

• New interactive DDEV TUI (terminal user interface). Try it out! Just type ddev. See the Interactive Dashboard and Terminal Compatibility documentation.
• Users of v1.25.0 are encouraged to upgrade due to multiple fixes and stability improvements.

Bug Fixes

MariaDB / Database

• Use MariaDB 10.11 client for older MariaDB servers, fixing the v1.25.0 error: "TLS/SSL error: SSL is required, but the server does not support it".
• Automatically add --skip-ssl-verify-server-cert for MariaDB 11.x clients.
• Fixed mixed collation errors after ddev import-db for utf8mb4_uca1400_ai_ci (MariaDB) and utf8mb4_0900_ai_ci (MySQL) introduced in v1.25.0.

Traefik / Router

• Fixed Traefik router healthcheck warnings for stopped projects.
• Copy all certificates from .ddev/traefik/certs to ddev-router, not only auto-generated ones.
• Copy Traefik-related files directly to ddev-router without intermediate containers to avoid healthcheck issues.
• Restored support for custom Traefik project configurations removed in v1.25.0.
• Fixed Traefik router communication between containers/projects that was partially broken in v1.25.0.
• Clean up Traefik staging directories on poweroff to prevent downgrade issues (notably with v1.24.10).
• Do not report Traefik warnings in ddev-router healthchecks, thanks to @jonesrussell.

Remote Docker

• Skip port checks for remote Docker hosts, thanks to @svicervlad.
• Automatically bind all interfaces for remote Docker hosts.
• Fixed broken TLS connection to remote Docker hosts introduced in v1.24.8.

Other Fixes

• Fixed AVIF and HEIC write support in ImageMagick 7.
• Remove unnecessary warnings for files during ddev pull, thanks to @jonesrussell.
• Use Composer 2.2 LTS automatically when Composer 1 (deprecated and non-working) is requested, thanks to @jonesrussell.
• Show warnings/errors in ddev share that could previously be hidden.
• Fixed non-working ddev share on traditional Windows (regression from v1.25.0).

Internal Improvements

• Check for Docker Buildx plugin (required by Docker Compose).
• Added retry logic for docker-compose build, see [#8136].
• Added WSL2 testing in GitHub Actions.

Minor Updates

• PHP 8.4.18 and 8.5.3.

What's Changed

• chore(schema): Minor updates to schema.json [skip ci] by @rfay in https://github.com/ddev/ddev/pull/8097
• fix: router healthcheck incorrectly warns when all projects stopped, fixes [#8081] by @Copilot in https://github.com/ddev/ddev/pull/8082
• docs: note that "pull acquia" uses latest available backup by @damienmckenna in https://github.com/ddev/ddev/pull/8107
• docs: Do not include version with create-project when using Drupal official release by @gitressa in https://github.com/ddev/ddev/pull/8068
• fix(webserver): add AVIF and HEIC write support for ImageMagick by @stasadev in https://github.com/ddev/ddev/pull/8104
• docs(claude): Minor casual edits to CLAUDE.md [skip ci] by @rfay in https://github.com/ddev/ddev/pull/8112
• test(traefik): add TestCustomProjectConfig for custom project-level Traefik configuration by @rfay in https://github.com/ddev/ddev/pull/8114
• fix(traefik): copy all traefik certs from project to router, fixes [#8100], replaces [#8108] by @rfay in https://github.com/ddev/ddev/pull/8113
• fix(traefik): Attempt to fix possible fsnotify problems with traefik and config by @rfay in https://github.com/ddev/ddev/pull/8116
• fix(docker): handle TLS, improve ddev utility dockercheck, fixes [#8111] by @stasadev in https://github.com/ddev/ddev/pull/8115
• chore: fix webimage_extra_packages example in config.yaml by @joelpittet in https://github.com/ddev/ddev/pull/8122
• fix: suppress files_pull warning when provider has files_import_command, fixes [#8103] by @jonesrussell in https://github.com/ddev/ddev/pull/8123
• fix(ddev-router): only show Traefik ERR (not WRN) as config problems, fixes [#8102] by @jonesrussell in https://github.com/ddev/ddev/pull/8125
• test(quickstart): use flexible regex for WordPress REST API link header [skip buildkite] by @rfay in https://github.com/ddev/ddev/pull/8133
• chore(vscode): Minor launch.json fiddles [skip ci] by @rfay in https://github.com/ddev/ddev/pull/8134
• docs: update ddev.readthedocs.io URLs to docs.ddev.com [skip ci] by @rfay in https://github.com/ddev/ddev/pull/8137
• fix(config): replace composer_version 1 option with 2.2 (LTS), fixes [#8084] by @jonesrussell in https://github.com/ddev/ddev/pull/8126
• docs: add PR creation guidance for gh pr create/edit [skip ci] by @rfay in https://github.com/ddev/ddev/pull/8140
• fix: skip port check for remote Docker hosts by @svicervlad in https://github.com/ddev/ddev/pull/8128
• docs: Add "tested on" badge to README by @tyler36 in https://github.com/ddev/ddev/pull/8118
• fix: add timeout to IsPortActive to prevent macOS hangs by @rfay in https://github.com/ddev/ddev/pull/8147
• fix(compose): add retry logic for docker-compose build BuildKit snapshot race condition, for [#8136] by @Copilot in https://github.com/ddev/ddev/pull/8142
• ci: add WSL2 GitHub Actions testing workflow, for [#6444] by @rfay in https://github.com/ddev/ddev/pull/8151
• fix(ci): fetch upstream tags in WSL2 workflow for correct version detection, for [#8151] by @rfay in https://github.com/ddev/ddev/pull/8153
• feat: merge multiple traefik config files per project, fixes [#8047] by @Copilot in https://github.com/ddev/ddev/pull/8109
• fix: use valid bind addresses for remote Docker hosts by @rfay in https://github.com/ddev/ddev/pull/8139
• fix(router): recreate router when network aliases change, fixes [#8110] by @rfay in https://github.com/ddev/ddev/pull/8132
• chore(traefik): Clean up traefik staging directories on poweroff to prevent downgrade issues, fixes [#8120] by @Copilot in https://github.com/ddev/ddev/pull/8135
• feat: add Docker buildx plugin as hard requirement, fixes [#8117] by @rfay in https://github.com/ddev/ddev/pull/8149
• fix: remove check for no-bind-mounts in remote Docker, for [#8139] by @stasadev in https://github.com/ddev/ddev/pull/8158
• fix: run share provider scripts via bash, fixes Windows ddev share by @rfay in https://github.com/ddev/ddev/pull/8157
• feat(mariadb): use 10.11 client for <11.x servers, add --skip-ssl-verify-server-cert wrappers for 11.x, fixes [#8119] by @stasadev in https://github.com/ddev/ddev/pull/8141
• docs: Remove architecture specification for Homebrew installation by @rfay in https://github.com/ddev/ddev/pull/8160
• feat(tui): add Bubble Tea TUI dashboard with detail view, logs, and project management, fixes [#5762] by @rfay in https://github.com/ddev/ddev/pull/8144
• fix(share): simplify ddev share provider scripts and show output in real-time by @stasadev in https://github.com/ddev/ddev/pull/8156
• test(quickstart): fix wagtail hang, reduce job timeout to 60m by @rfay in https://github.com/ddev/ddev/pull/8164
• test: fix intermittent and cleanup issues in TestCmdAddonPHP by @rfay in https://github.com/ddev/ddev/pull/8161
• test(wsl): increase time limit for test [skip ci] by @rfay in https://github.com/ddev/ddev/pull/8166
• build(docker): bump images to v1.25.1 for release, fixes [#8162] by @stasadev in https://github.com/ddev/ddev/pull/8163
• fix(import-db): replace modern collations with server default, fixes [#8129], fixes [#8130] by @stasadev in https://github.com/ddev/ddev/pull/8138
• feat(tui): add viewport scrolling for dashboard and detail views by @stasadev in https://github.com/ddev/ddev/pull/8169

New Contributors

• @svicervlad made their first contribution in https://github.com/ddev/ddev/pull/8128

Full Changelog: https://github.com/ddev/ddev/compare/v1.25.0...v1.25.1