DDEV: baixar versions anteriors

## Installation

See the [installation instructions](https://docs.ddev.com/en/stable/users/install/ddev-installation/) 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](https://docs.ddev.com/en/stable/users/install/ddev-installation/#linux)
⚠️ **Linux apt/yum users**：packages are now served from Cloudsmith (`packages.ddev.com`). Your existing Gemfury (`pkg.ddev.com`) setup keeps working, but please re-run the [Linux installation steps](https://docs.ddev.com/en/stable/users/install/ddev-installation/#ddev-installation-linux) to switch over.
• Windows and WSL2：Download the [Windows Installer](https://ddev.com/download/); 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

• **Database seeding and reset:** `ddev start --seed-snapshot=<name-or-path>` fills a new database from any snapshot, and `ddev start --reset-database` deletes the current database and starts fresh, see **Snapshots and Database Seeding** below
• **MySQL 9.7 LTS support**, and MySQL 8.0/8.4 now build from [Docker Hardened Images](https://hub.docker.com/hardened-images/catalog/dhi/mysql/images) (`dhi.io/mysql`) instead of `bitnamilegacy/mysql`, which gets no updates
• **Env files:** `.env.local` for values you don't want in Git, several files per service separated by a label, and global files that apply to every project, see [Environment Variables](https://docs.ddev.com/en/stable/users/configuration/environment-variables/)
• **Set things once for every project:** global Dockerfiles in `~/.ddev/web-build/` and `~/.ddev/db-build/`, and global env files in `~/.ddev/.env*`, see **Global Configuration** below
• **apt/rpm packages are now published to Cloudsmith** (`packages.ddev.com`) as well as Gemfury, and the yum repo now verifies package signatures, which the Gemfury one never did. Gemfury (`pkg.ddev.com`) is still supported but will be retired eventually; see the Linux note above to switch over

## Snapshots and Database Seeding

• A snapshot named `seed` is automatically loaded when you start a project with an empty database. So if you delete your db or project and then `ddev start`, you'll have the database from the `seed` snapshot.
• [`ddev start --seed-snapshot`](https://docs.ddev.com/en/stable/users/usage/database-management/#seeding-a-fresh-database-from-a-snapshot) fills a new database from a snapshot in `.ddev/db_snapshots`, or from a path to one anywhere else on your machine. A snapshot outside the project is read where it is instead of being copied, so a multi-GB file is not duplicated. A snapshot named `seed` is used automatically, with no flag. Works for MariaDB, MySQL, and PostgreSQL
• [`ddev start --reset-database`](https://docs.ddev.com/en/stable/users/usage/database-management/#starting-over-with-a-new-database) deletes the database and starts fresh. It takes a snapshot first, using the database version that created the data, so this also works when you already changed `database:` in your config. `ddev config --database=` now warns instead of failing, and `ddev delete` no longer refuses to work on a project whose data came from a different database server
• `ddev snapshot restore --force` restores a snapshot made by a different version of the same database server
• `ddev snapshot --list` shows each snapshot's size and database version
• `ddev snapshot restore` and `ddev snapshot --list` also see snapshots from other Git worktrees of the same repository, so a database doesn't have to be 

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
Blog announcement: https://ddev.com/blog/release-v1-25-3/
- New Docker Compose library: Improved UX during ddev start and ddev stop; the separate ~/.ddev/bin/docker-compose binary is no longer needed and can be removed
- Faster ddev start: Reduced startup time by running post-healthcheck tasks concurrently, thanks to @jonesrussell
- Faster ddev stop: Fixed a bug in the webserver startup script that added an unnecessary ~10-second delay
- MariaDB 12.3 LTS support
- Podman and Docker rootless are no longer experimental: Both are now stable and ready for general use:
- macOS (Podman rootless)
- Linux/WSL2 (Docker rootless)
- Linux/WSL2 (Podman rootless)
Breaking Changes
- Remove support for XDG_CONFIG_HOME, replaced by DDEV_XDG_CONFIG_HOME. Support for ~/.config/ddev on Linux is unchanged. This change was needed because some IDEs, such as PhpStorm, don't always see XDG_CONFIG_HOME set in the terminal (see this issue), which caused the IDE to recreate the ~/.ddev directory repeatedly
- Use stricter permissions for world-writable directories inside ddev-webserver. If you had post-start hooks that wrote to /usr/local/bin, update them to use ~/.local/bin instead, thanks to @AkibaAT
- Move N_PREFIX from /usr/local to /usr/local/n. This shouldn't affect most people, unless you referenced a full path such as /usr/local/bin/npm - the new location is /usr/local/n/bin/npm, or simply use npm without a full path
- Remove the ddev dr alias for ddev drush, since dr is now a built-in command for Drupal 11.4+
Features
- Node.js improvements: preserve nodejs_version in .ddev/config.yaml, and install several Node.js versions with n install <version> inside the web container
- Docker rootless on Linux no longer requires no-bind-mounts; disable it with ddev config global --no-bind-mounts=false
- Support the gvisor-tap-vsock network driver in Docker rootless
- Add new ddev dr command for Drupal 11.4+
- Allow using Mutagen together with ddev config global --use-hardened-images=true
- ddev version and ddev config now work even when Docker isn't running or is broken, and ddev poweroff shows progress output instead of appearing to hang
- Improve ddev list and ddev describe layout on narrow terminals
- Add OSC 8 terminal hyperlink support to ddev list, ddev describe, ddev add-on list, and ddev add-on search
- Show human-readable output when checking available disk space, thanks to @wolcen
- Always pull images when using ddev start --no-cache
- Respect the COMPOSER_NO_BLOCKING environment variable from the host in ddev composer
- Add ddev config global --docker-buildx-version to specify which Docker Buildx version to use (advanced use only)
- Respect docker-buildx installed via snap on Linux
- Support Debian, Kali, and eLxr WSL2 distros in the Windows installer, and avoid installing docker-ce over an existing Docker Desktop docker binary
- Add ddev utility addon-update-checker command for add-on maintainers
- Add #ddev-interactive option for add-on actions, thanks to @AkibaAT
- Add x-ddev.omit-ddev-labels extension to skip com.ddev.* label injection for specific services
- Support the Flatpak user binary for DBeaver on Linux, thanks to @nickchomey
- Add a quickstart for Drupal 12 (HEAD), thanks to @rpkoller
- Add troub

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
- Faster ddev start: Reduced fresh-router healthcheck wait
- New project types and quickstarts: 3 new project types (wp-bedrock, asterios, joomla) and 2 new quickstarts (Tempest, October CMS)
- Auto-start on command: DDEV now automatically starts stopped projects when you run ddev exec, ddev ssh, ddev share, ddev xhgui, ddev pull, ddev push, or ddev snapshot restore
- New diagnostic commands: ddev utility port-diagnose to identify port conflicts, ddev utility check-custom-config to detect unexpected configuration, ddev utility tls-diagnose to identify TLS/SSL problems with DDEV projects.
Quickstarts
- Add wp-bedrock project type, thanks to @jonesrussell
- Add asterios project type, thanks to @asteriosphp
- Add joomla project type, thanks to @renekreijveld
- Add Tempest quickstart
- Add October CMS quickstart, thanks to @daftspunk
- Update Contao quickstart to use 5.7 LTS, thanks to @fkaminski
- Update Laravel quickstart to latest version, thanks to @tyler36
- Update Moodle quickstart to set admin email during installation
Features
- Support bare variable names in web_environment for host environment passthrough
- Add project path to the interactive dashboard, thanks to @yanniboi
- Add global omit_snapshot_on_delete setting, thanks to @marklabrecque-ab
- Add --project flag to ddev exec, thanks to @penyaskito
- Use runtime environment variables in wp-config-ddev.php for WordPress, thanks to @jonesrussell
- Add support for symfony_mailer 2.x in Drupal config, thanks to @hchonov
- Display project info (name and environment) when calling ddev pull/ddev push, thanks to @mariano-dagostino
- Support virtioproxy WSL2 networking mode
- Support "1"/"0" for DDEV_* environment variables (e.g. DDEV_DEBUG=1), thanks to @deviantintegral
- Automatically set com.ddev.* labels for Docker images, containers, and networks
- Add aggregate_gc_threshold=0 to Drupal 12 config, thanks to @rpkoller
Bug Fixes
- Detect custom configuration files and show unexpected configuration on ddev start
- Prevent Path Traversal (ZipSlip), thanks to @SnailSploit
- Normalize PHP_IDE_CONFIG (PhpStorm) for uppercase project names
- Reduce file permissions for system directories /usr/bin and /usr/sbin inside the container, thanks to @AkibaAT
- Ensure ddev-ssh-agent and ddev-router are up to date on DDEV upgrade
- Respect webimage for all use cases; don't pull the default web image when it's not in use
- Simplify ddev composer create-project by removing the composer update step
- Add timeout to yarn config set in start.sh for the ddev-webserver Docker image
- Fix malformed WSLENV on Windows install/uninstall
Internal Improvements
- Implement config model using Viper, thanks to @agviu
- Improve testing in GoLand by prebuilding the ddev binary, thanks to @jonesrussell
- Add missing php8.5-memcached for ARM64 to ddev-webserver Docker image
- Use newer deb822 format (*.sources instead of *.list) for Docker and DDEV repositories (Linux and WSL2)
Minor Updates
- PHP 8.4.20 and 8.5.5
- Docker Compose v5.1.3
- Remove obsolete ddev sequelpro command and vestiges in documentation
What's Changed
- fix(commands): use /usr/bin/env bash in web console command by @tyler36 in #8182
- build(deps): bump actions/upload-artifact from 6 to 7 by @dependabo

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.
- Skip port checks for remote Docker hosts, thanks to @svicervlad.
- Automatically bind all interfaces for remote Docker hosts.
- 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 

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. winget install --interactive ddev works too.
⚠️ 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 defaults
- Debian Trixie is now the base image for ddev-webserver and ddev-ssh-agent (replacing Debian Bookworm). See Issues to be aware of for Trixie.
(Some projects with complex Dockerfiles or obsolete webimage_extra_packages may need to be updated.)
- XHGui is now the default profiler (prepend mode remains available via ddev config global --xhprof-mode=prepend).
- Node.js v24 is default in new projects (replacing Node.js v22)
- PHP 8.4 is default in new projects (replacing PHP 8.3)
- MariaDB 11.8 is default in new projects (replacing MariaDB 10.11)
Additional highlights
- Completely revised Windows installer now uses per-user installation for WSL2 or traditional Windows (no admin account required)
- Reworked configurable ddev share command with a new cloudflared share provider, see (draft) New ddev share Provider System Brings Free Sharing Options
- Add ddev utility xdebug-diagnose command, see (draft) Xdebug in DDEV: Understanding, Debugging, and Troubleshooting Step Debugging
- Add ddev utility mutagen-diagnose command, see (draft) Mutagen in DDEV: Functionality, Issues, and Debugging
- ddev pantheon pull got new DDEV_PANTHEON_SITE, DDEV_PANTHEON_ENVIRONMENT, DDEV_USE_PANTHEON_BACKUP variables, see updated Pantheon Integration
- ddev snapshot now uses zstd instead of gzip for significantly faster exports and restores, thanks to @deviantintegral
- Add CodeIgniter project type, thanks to @Franky5831
- Experimental support for Podman and Docker Rootless, see Podman and Docker Rootless in DDEV
- ddev-frankenphp is an official add-on with many improvements, see updated (draft) Using FrankenPHP with DDEV
Features
- New Wagtail (Python, Generic) quickstart
- Added Drupal 12 project type (development branch). Drupal 12 has not yet been released, but it's showing up in developer builds already.
- New --no-cache flag for ddev start and ddev restart (as an alternative to ddev utility rebuild)
- Improved support for non-Codespaces devcontainers
- Refactored ddev add-on subcommands with a fallback mechanism to avoid GitHub API rate limits
- Much faster ddev add-on list and ddev add-on search
- Shell autocompletion for ddev add-on get <TAB>
- SELinux enviroment detection (auto SELinux label for bind mounts)
- Support for additional SSH config files (*.conf) in .ddev/homeadditions/.ssh/config.d (global or project-level), see SSH confugation, thanks to @codebymikey
- More portable database collations. Databases imported and exported from newer MySQL and MariaDB are less likely to have problems with proprietary collations like utf8mb4_0900_ai_ci and utf8mb4_uca1400_ai_ci as they use more traditional collations in DDEV.
- DBeaver support for traditional Windows, thanks to @ddubau
Traefik Router Features, Fixes, and Breaking Changes
- Project Traefik configuration is now standardized to a single file: .ddev/traefik/config/<projectname>.yaml (all other files are ignored). See issue #8047.
- Add any global Traefik configuration inside the $HOME/.ddev/traefik/custom-global-config/ directory
- Removed defaultRuleSyntax: v2 and ruleSyntax: v3 from Traefik configs. Traefik v3 syntax is now used by default.
- Traefik configuration errors now show warnings instea

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 ddev_windows_amd64_installer.v1.24.10.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.
Note
This is a bugfix release. A regression in v1.24.9 prevented DDEV from updating the /etc/hosts file in CI environments (e.g., GitHub Actions) when using custom project TLDs:
- v1.24.10 reverts the change "Non-interactive mode now forced in non-tty environments"
Highlights
- Support for PHP 8.5.0 RC 3 (note: some extensions are not yet available: apcu, imagick, memcached, redis, uploadprogress, xdebug, xhprof, xmlrpc, yaml)
- Support for PostgreSQL 18
- Automatic HTTP/S communication between DDEV projects - no need to manually configure external_links
- Option to omit project names in .ddev/config.yaml by default with ddev config global --omit-project-name-by-default=true - useful when working with multiple Git worktrees
- Auto-discovery of PLATFORM_PROJECT and PLATFORM_ENVIRONMENT from existing config for Upsun Flex and Upsun Fixed (Platform.sh) provider integrations
Features
- New ddev utility diagnose command for quick diagnostics on your DDEV installation and current project
- New ddev add-on search command, thanks to @AkibaAT
- New ddev xdebug info command to display xdebug_info() output
- Customize ddev describe output using the x-ddev.describe-* extensions - useful for add-ons
- Change ddev ssh shell using the x-ddev.ssh-shell extension - useful for add-ons
- New --user/-u flag for ddev exec and ddev ssh
- exec hooks now support the user field
- New pre-share and post-share hooks. This can help change the required URL for ddev share in CMSs like WordPress and Magento2.
- PostgreSQL connection support in ddev heidisql, thanks to @raphaelportmann
- Show failed container logs on project start by running DDEV_DEBUG=true ddev start
- Enhanced composer_root support for app type detection in CakePHP, Craft CMS, Laravel, Magento 2, Shopware 6, and Symfony, thanks to @vanWittlaer for initial PR for Shopware 6
- Silence warnings about custom configuration files in the .ddev directory by adding #ddev-silent-no-warn to the file. Documentation
Bug Fixes
- PostgreSQL now runs as container user (mirrored from host user) instead of postgres:postgres
- ddev describe now works with stopped or broken containers
- Improved support for DDEV_* environment variables in PHP-based add-ons
- APP_DEFAULT_LOCALE is no longer overridden in CakePHP, thanks to @tyler36
- Removed hardcoded --server-id=0 parameter from MySQL/MariaDB startup, thanks to @cyppe
- Fixed docker-compose warnings on ddev start when project root .env file contains dollar signs
- ddev add-on get now retries without authentication on invalid GitHub token
- Debug and verbose output now suppressed when using --json-output/-j flag
- Improved container username sanitization with better fallback handling
- Fixed blackfire-php installation for older PHP versions
- Fixed bug with broken label in Mutagen volume when path to Docker socket is too long
- Fixed intermittent hang in ddev auth ssh when SSH key is password-protected
- Fixed hang in ddev start on macOS when temp directory permissions are broken after macOS upgrade (fixed in docker-compose)
Internal Improvements
- PHP 8.1 no longer preinstalled in ddev/ddev-webserver to reduce image size
- Native ARM builder now used for building DDEV Docker images, thanks to @AkibaAT
- ddev utility is now the primary command (ddev debug moved to alias)
- Healthcheck added to ddev/ddev-xhgui image
- Linux tests now run separately instead of in matrix, allowing single test rest

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 --only-upgrade ddev, see apt/yum installation
- Windows and WSL2: Download the ddev_windows_amd64_installer.v1.24.9.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
- Support for PHP 8.5.0 RC 3 (note: some extensions are not yet available: apcu, imagick, memcached, redis, uploadprogress, xdebug, xhprof, xmlrpc, yaml)
- Support for PostgreSQL 18
- Automatic HTTP/S communication between DDEV projects - no need to manually configure external_links
- Option to omit project names in .ddev/config.yaml by default with ddev config global --omit-project-name-by-default=true - useful when working with multiple Git worktrees
- Auto-discovery of PLATFORM_PROJECT and PLATFORM_ENVIRONMENT from existing config for Upsun Flex and Upsun Fixed (Platform.sh) provider integrations
Features
- New ddev utility diagnose command for quick diagnostics on your DDEV installation and current project
- New ddev add-on search command, thanks to @AkibaAT
- New ddev xdebug info command to display xdebug_info() output
- Customize ddev describe output using the x-ddev.describe-* extensions - useful for add-ons
- Change ddev ssh shell using the x-ddev.ssh-shell extension - useful for add-ons
- New --user/-u flag for ddev exec and ddev ssh
- exec hooks now support the user field
- New pre-share and post-share hooks. This can help change the required URL for ddev share in CMSs like WordPress and Magento2.
- PostgreSQL connection support in ddev heidisql, thanks to @raphaelportmann
- Show failed container logs on project start by running DDEV_DEBUG=true ddev start
- Enhanced composer_root support for app type detection in CakePHP, Craft CMS, Laravel, Magento 2, Shopware 6, and Symfony, thanks to @vanWittlaer for initial PR for Shopware 6
- Silence warnings about custom configuration files in the .ddev directory by adding #ddev-silent-no-warn to the file. Documentation
Bug Fixes
- PostgreSQL now runs as container user (mirrored from host user) instead of postgres:postgres
- ddev describe now works with stopped or broken containers
- Improved support for DDEV_* environment variables in PHP-based add-ons
- APP_DEFAULT_LOCALE is no longer overridden in CakePHP, thanks to @tyler36
- Removed hardcoded --server-id=0 parameter from MySQL/MariaDB startup, thanks to @cyppe
- Fixed docker-compose warnings on ddev start when project root .env file contains dollar signs
- ddev add-on get now retries without authentication on invalid GitHub token
- Debug and verbose output now suppressed when using --json-output/-j flag
- Non-interactive mode now forced in non-tty environments
- Improved container username sanitization with better fallback handling
- Fixed blackfire-php installation for older PHP versions
- Fixed bug with broken label in Mutagen volume when path to Docker socket is too long
- Fixed intermittent hang in ddev auth ssh when SSH key is password-protected
- Fixed hang in ddev start on macOS when temp directory permissions are broken after macOS upgrade (fixed in docker-compose)
Internal Improvements
- PHP 8.1 no longer preinstalled in ddev/ddev-webserver to reduce image size
- Native ARM builder now used for building DDEV Docker images, thanks to @AkibaAT
- ddev utility is now the primary command (ddev debug moved to alias)
- Healthcheck added to ddev/ddev-xhgui image
- Linux tests now run separately instead of in matrix, allowing single test restarts on failure
- Improved support for CI=true in GitHub Actions
- Vite setup documentation migrated into DDEV docs, thanks to @mandrasch for continuous support on the blog article
- Improved qu

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.8.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.
NEW: Docker Buildx is now required for Docker Compose
> Error: Docker Compose is configured to build using Bake, but buildx isn't installed
Docker Compose changed its default builder to Bake in v2.37.0.
DDEV v1.24.7 and below used the legacy builder, but v1.24.8 has switched to the new Bake builder, which requires Docker Buildx to be installed.
Solution: Ensure Docker Buildx is installed on your system. Most modern Docker installations include Buildx by default, but if you encounter this error, you may need to update Docker or manually install the Buildx plugin.
Highlights
- Experimental support for add-ons written primarily in PHP
- ddev add-on get can now automatically download add-on dependencies
- ddev add-on get <your **PRIVATE** GitHub repo>: Support for DDEV_GITHUB_TOKEN as a bearer token for GitHub downloads and private GitHub add-ons
- Parallel Docker image pulls for faster performance, thanks to @glensc for the idea
- Improved Pantheon provider support, .ddev/providers/pantheon.yaml provided by default
- Upsun support for multiple apps and multiple databases
- https://docs.ddev.com/ is now the canonical documentation source (replaces https://ddev.readthedocs.io/)
- Dynamic DDEV project sponsorship information if provided once a day on ddev start.
Features
- ddev debug download-images --all now pulls all images for all projects
- ddev heidisql now works on Linux, thanks to @punkrock34
- Support for alternative GitHub token environment variables: DDEV_GITHUB_TOKEN (highest priority), GH_TOKEN (lower priority than DDEV_GITHUB_TOKEN), GITHUB_TOKEN (lowest priority)
- New ddev npx global command, thanks to @dragonwize
- host.docker.internal now available in all containers, not just web
- Pantheon provider now always pulls current upstream database (instead of a backup) and uses the Terminus rsync plugin for file push, thanks to @danny2p
- Traefik healthcheck extended to validate file routers and detect config errors
- Improved support for ddev config global --no-bind-mounts with automated testing
- Manual testing with macOS 26 Tahoe (beta) shows no obvious problems; All Docker providers were casually tested.
Bug Fixes
- Fix non-working ddev-hostname for Homebrew installations on Linux
- Add missing ephemeral port handling to XHGui service, thanks to @AkibaAT
- Allow .DS_Store files in ddev composer create-project
- Fix ddev describe to show exposed ports correctly on new Docker Desktop versions
- Fix nginx configuration for Backdrop routes conflicting with directories
- Use stable branch for magerun autocompletion script
- Don't edit Laravel database config in .env when no database is present, thanks to @cyppe
- Remove obsolete PHP 8.4 php.ini configuration, thanks to @kaystrobach for the report
- Improve handling of "Failed to copy script" errors in the Windows installer
Internal Improvements
- Major refactoring of internal Docker logic to reduce API calls and improve error handling
- Set 20-minute download timeout for docker-compose and retry with doubled timeout on context deadline exceeded
- Remove docker context inspect calls from each ddev command and use the Docker CLI API
- ddev auth ssh now uses the Docker API instead of docker run and supports stdin
- Better reporting of MariaDB/MySQL/PostgreSQL client installation failures; removed download timeouts
- Replace the Docker image busybox:stable with ddev/ddev-utilities:latest for internal use
Minor Updates
- PHP 

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.exe below; 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.
- 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.
- 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
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 che

Installation
See the installation instructions for details, but it's easy:
- macOS: brew install ddev/ddev/ddev or just brew upgrade ddev.
- Linux or WSL2: Use apt install ddev or apt upgrade ddev see apt/yum installation.
- Traditional Windows: Use choco upgrade -y ddev, or download the ddev_windows_installer below.
- 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
This is a bugfix release. There were several regressions in v1.24.5 that needed some work:
- Increase timeout for downloading docker-compose on slower networks.
- Fix support for TYPO3 v12 and below (adding support for TYPO3 v14 broke some nginx routing).
- Fix Craft CMS problem with passing values from .ddev/.env.web to web container.
Minor Updates
- Add checks for "generic" webserver without 80/443 ports.
- Make "generic" webserver work with busy 80/443 ports.
- Bump docker-compose to v2.36.1.
Otherwise, same features as in v1.24.5.
What's Changed
- build: update brew instructions for old formula, fixes #7297 by @stasadev in #7295
- fix: change download timeout to 5 minutes instead of 20s, fixes #7298 by @rfay in #7300
- fix: Make sure env-type settings are populated before start, don't override .ddev/.gitignore file, for #7236 by @rfay in #7286
- fix: make TYPO3 nginx config work with TYPO3 v12, fixes #7299, for #7230 by @stasadev in #7301
- build: bump docker-compose to v2.36.1 by @stasadev in #7311
- test: adding quickstarts for typo3 v13 and v12 plus bats tests by @rpkoller in #7302
- feat: make generic webserver work with ephemeral ports by @stasadev in #7171
- fix: add checks for "generic" webserver without 80/443 ports, for #6935, fixes #7313 by @stasadev in #7306
- docs: fix indentation for code block by @stasadev in #7314
- build: bump images to v1.24.6 for release, fixes #7310 by @stasadev in #7315
Full Changelog: v1.24.5...v1.24.6

Installation
See the installation instructions for details, but it's easy:
- macOS: brew install ddev/ddev/ddev or just brew upgrade ddev.
- Linux or WSL2: Use apt install ddev or apt upgrade ddev see apt/yum installation
- Traditional Windows: Use choco upgrade -y ddev, or download the ddev_windows_installer below.
- 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
- Improved (experimental) support for WSL2 "Mirrored" Networking. Fixed port waiting timeouts (thanks to @marvinhinz) and added automatic Xdebug connection configuration.
If you're using Windows WSL2 with "Mirrored" Networking, set the experimental hostAddressLoopback=true feature.
- Resolved "unknown" state caused by PhpStorm's use of docker-compose run for one-off containers. The DDEV Integration plugin will no longer fail in this case. Edge cases with Node remain; see JetBrains issue WEB-64513.
- VPN or Proxy configuration with DDEV? A dedicated Special Network Configurations docs page is now available.
- Want to learn more about DDEV? AI-generated insights available at ddev/ddev | DeepWiki.
Features
- Downloaded Mutagen and docker-compose binaries now pass SHA checksum verification with retry logic.
- New environment variables: DDEV_PRIMARY_URL_PORT, DDEV_PRIMARY_URL_WITHOUT_PORT, and DDEV_SCHEME. Thanks to @AkibaAT.
- DDEV_APPROOT variable available in the web container. Thanks to @shelane.
- Support for prepend.Dockerfile* files for multi-stage Docker builds. Thanks to @hanoii.
- Improved output of ddev add-on get and added warning exit code. Thanks to @hanoii.
- WordPress --path is now added automatically to ddev wp when docroot is set. Thanks to @pfructuoso from www.nazaries.com.
- Craft CMS settings now reside in .ddev/.env.web; .env is no longer managed by DDEV.
- Added shell completion for the --service (-s) flag in ddev exec, ddev logs, ddev ssh, ddev debug rebuild.
Bug Fixes
- Remove redundant media stanzas from nginx.conf. Thanks to @barbieswimcrew.
- ddev xhgui launch now correctly respects non-default ports. Thanks to @PierrePaul.
- Avoid overriding WP_ENVIRONMENT_TYPE for WordPress.
- ddev config now works with non-default project names in config.*.yaml.
- Prevent PhpStorm's debug integration from triggering stdin-related connections. Thanks to @AkibaAT.
- PostgreSQL exports now use fast checkpoints to avoid prolonged backup blockages. Thanks to @AkibaAT.
- ddev_version_constraint now supports wildcards like 1.24.x and comparison operators like > 1.24.5.
- Fixed broken HTTP/HTTPS port resolution. Thanks to @AkibaAT.
Deprecations
- ddev composer create is deprecated. Use ddev composer create-project.
- ddev debug capabilities is deprecated. Use ddev_version_constraint for project and add-on checks.
Minor Updates
- PHP 8.3.21 and 8.4.7.
- docker-compose v2.36.0.
- Chocolatey removed from automated Windows installation scripts. Thanks to @colans.
- Magento 2 quickstart now uses OpenSearch. Drupal CMS quickstart improved. Thanks to @rpkoller.
- Updated Craft CMS quickstart. Thanks to @timkelty.
- ddev start checks for an index.* file in docroot and warns if missing (403 errors in browser).
- Pimcore quickstart now requires a license due to upstream license change.
What's Changed
- docs: Add missing sequelace command link to database-management.md by @TravisCarden in #7184
- docs: add tip on using per-project API tokens for hosting providers, fixes #7177 by @stasadev in #7183
- fix: ignore curl error in Dockerfile.test for ddev debug test by @stasadev in #7186
- fix: don't wait for one-off containers from PhpStorm, fixes #7146 by @stasadev in #7148
- fix: add timeout for netutil::IsPortActive check for WSL2 with "mirrored networking mode" as opposed to default "NAT mode", fixes #6245 by @marvinhinz in #7166
- fix: nginx.conf should let index.php handle 404 error

Installation
See the installation instructions for details, but it's easy:
- macOS: brew install ddev/ddev/ddev or just brew upgrade ddev.
- Linux or WSL2: Use apt install ddev or apt upgrade ddev see apt/yum installation
- Traditional Windows: Use choco upgrade -y ddev, or download the ddev_windows_installer below.
- 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:
- Sponsored by the TYPO3 Community: Integrate XHGui into DDEV, enable it with ddev poweroff && ddev config global --xhprof-mode=xhgui, then use ddev xhgui in any of your projects.
- DevDb VS Code extension: First class support for DDEV, thanks to @damms005
Features:
- Optional Docker Compose profiles: You can now start projects with specific profiles using ddev start --profiles=list,of,profiles
- Backdrop: a new quickstart based on the official add-on, thanks to @laryn
- New MutagenSync annotation: Custom commands that alter the host system can now use this annotation to help synchronize changes.
Bug Fixes:
- DDEV router now works properly behind proxies (regression from v1.24.0).
- Show router URLs in ddev describe and ddev list when default 80/443 port is busy (regression from v1.24.3).
- Correct status color formatting in ddev describe and ddev list.
- Remove outdated Traefik images with ddev delete images, thanks to @rpkoller
- Resolve misleading errors in ddev debug test when run outside the project root.
- Fix invalid upload_dirs on traditional Windows setups.
- Sanitize ~/.ddev/project_list.yaml to prevent panic.
- Make the DDEV_PAGER environment variable optional to prevent it from breaking wp-cli output.
- Prevent overwriting the generic project type when running ddev config --update.
- Update DATABASE_URL to use charset=utf8mb4 in MySQL and MariaDB for Symfony projects, thanks to @RubenColpaert
- Delete third-party built images on ddev delete.
Minor Updates:
- PHP 8.3.19 and 8.4.5
- Fix displaying for #ddev-description stanza in add-on install actions, thanks to @hanoii
- Show custom config.*.yaml on ddev start, thanks to @hanoii
- Laravel 12 quickstart with tests.
- Update DDEV brand logos for dark theme.
- Update all Go vendor dependencies.
- Add quickstart tests for Magento 2, CakePHP, ExpressionEngine, Kirby CMS, Symfony, Silverstripe CMS, CraftCMS, and Statamic, thanks to @rpkoller
- Add OpenMage/Magento 1 quickstart test and split it from Magento 2, thanks to @sreichel
What's Changed
- fix: the #ddev-description stanza in add-on install actions not showing if it's the first line by @hanoii in #7022
- feat: add go-version to ddev version, fixes #7021 by @stasadev in #7023
- feat: Add live link to Discord by @tyler36 in #7042
- docs: remove the recommendation not to use colima by @rfay in #7025
- build: fix new mkdocs failure on git by @rfay in #7046
- refactor: use ddev composer create-project in the code, for #6920 by @stasadev in #7027
- feat: Laravel 12 quickstart with tests by @stasadev in #7028
- fix: delete traefik images based on the pattern used for ddev-dbserver and use constants for targeting, fixes #6326 by @rpkoller in #7036
- feat: Support docker compose optional profiles, allow ddev start --profiles=list,of,profiles, for #6894 by @rfay in #7007
- fix: explicitly ping 127.0.0.1 in Traefik healthcheck to make proxying work, fixes #7044, fixes #6931 by @stasadev in #7045
- fix: remove refreshenv from WSL2 install scripts, fixes #7024 [skip ci] by @rfay in #7026
- docs: add Backdrop-specific config considerations. by @laryn in #7037
- build: don't use go 1.24 yet until docker issues resolved, fixes #7051 by @rfay in #7057
- test: Run quickstart tests with mutagen enabled [skip buildkite] by @rfay in #7017
- docs: Improve troubleshooting docs for hosting by @rfay in #7056
- build: skip testing with buildkite if diff is not from that branch by @stasa