Raised: $8,286
69% of monthly goal Help us cross the finish line!
Goal: $12,000
Raised: $8,286 Goal: $12,000
69% of monthly goal Help us cross the finish line!
Sponsor DDEV

Upsun Support for DDEV in a New Add-on

Randy Fay avatar
Randy Fay

October 2, 2025 4 min read

Edit this page
Sophisticated upsun support for DDEV

Introduction

We’re proud to announce that DDEV now has an Upsun add-on with extensive support for Upsun Flex and Upsun Fixed (Platform.sh-style configuration)!

Although DDEV has had ddev pull upsun support for Upsun projects for a couple of years, the add-on provides a more complete integration. It reads your Upsun configuration and automatically configures matching services in your local DDEV project, mirroring what your upstream project uses.

Getting Started

Getting started is straightforward:

  1. In your existing Upsun project directory, run: 
    ddev config
ddev add-on get ddev/ddev-upsun
ddev start
  2. The add-on will read your .upsun/config.yaml or .platform.app.yaml and configure your local environment automatically.

For more details, see the README.

What the ddev-upsun Add-on Does

When you do a ddev add-on get ddev/ddev-upsun the add-on reads your .upsun/config.yaml or .platform.app.yaml file and configures your DDEV project to match the upstream environment. This requires careful translation between Upsun’s cloud architecture and DDEV’s local environment.

  • Use the same PHP version and extensions.
  • Use the same database type and version (supporting multiple versions of MariaDB, MySQL, and PostgreSQL).
  • Detect the use of Redis, Memcache, and Opensearch and configure DDEV add-ons to mimic the Upsun configuration.

Why ddev-upsun Matters

Although many Upsun-hosted sites are basic nginx-fpm-database sites that DDEV has easily supported for years, the more complex ones have required special handling, like having to explicitly set PHP version, database type, etc. Now the add-on can do much of that for you.

For example, if your Upsun project uses PostgreSQL 15 with Redis and a specific PHP version, previously you’d need to manually configure each in your .ddev/config.yaml. Now, the add-on detects and configures all of this automatically.

Upsun is a great platform for developers, and so many of you use it in the new “Flex” style and the previous “Fixed” style (Platform.sh-style). The add-on makes it easy to use both with a single add-on.

And of course Upsun is the lead sponsor of DDEV, so we always delight in making it work for you.

The Future of ddev-upsun

A sophisticated platform like Upsun has many possibilities, and we want most things to work on most projects. The scope will be limited to PHP for now. However, we want to add:

  • Versioning for add-ons (Redis version will be supported in ddev/ddev-redis add-on, for example).
  • More service support, like Elasticsearch and Solr.
  • Even more extensive automated tests. Currently we have a very extensive set of tests based on a Drupal setup, but want to add tests for other frameworks and CMSes.

How We Got Here (PHP Add-ons)

DDEV v1.24.8 (required) adds support for add-ons written mostly in PHP. Originally, all add-ons were written in Bash, with Go templating. It worked great for so many simple add-ons, but was way too complicated for sophisticated ones. PHP is a familiar and powerful language for many add-on developers, so now provides a much more expressive way to write complex add-ons.

The ddev-platformsh add-on forced the issue on this. Every time we went back to it to maintain it we had to remember how Go templates worked and sort out complex Bash logic. Bash and Go templates are a lousy combination for maintainability. PHP should be much better. The ddev-upsun add-on will replace ddev-platformsh and supports both the Flex and Fixed Upsun configurations.

If you’re currently using the ddev/ddev-platformsh add-on, you can migrate to ddev-upsun by removing the old add-on with ddev add-on remove ddev-platformsh and adding the new one with ddev add-on get ddev/ddev-upsun.

What’s Next

  • Check out the full documentation for advanced configuration options.
  • We’d love your feedback — open issues or contribute PRs if you encounter any edge case.
  • If you like it, give us a star on GitHub.

Gratitude

Thanks as always to Upsun for their financial support and for the great products, and for access to testing accounts. Their continued support makes DDEV development possible.

If you’re not already an Upsun user, try an Upsun free trial.

Stay in the Loop—Follow Us and Join the Conversation

Reviewed with assistance from DDEV Contributors and Claude Code.

Posted In