github ddev/ddev v1.25.1
on GitHub

8 hours ago

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

New Contributors

Full Changelog: v1.25.0...v1.25.1

Check out latest releases or
releases around ddev/ddev v1.25.1

Don't miss a new ddev release

NewReleases is sending notifications on new releases.

Get notifications