DDEV provides integration with the Upsun by Platform hosting system, allowing Upsun users to easily download database and files from Upsun to a local DDEV-managed environment.
DDEV’s Upsun integration pulls databases and files from an existing Upsun site/environment into your local system so you can develop locally.
Upsun Global Configuration¶
You need to obtain and configure an API token first. This only needs to be done once.
- Login to the Upsun Dashboard and go to My Profile → API Tokens. Create an API token DDEV can use.
- Add the API token to the
web_environmentsection in your global DDEV configuration at
Upsun Per-Project Configuration¶
- Check out the Upsun site and configure it with
ddev config. You’ll want to use
ddev startand make sure the basic functionality is working.
UPSUN_ENVIRONMENTvariables to your project.
Or with a command from your terminal:
ddev pull upsun. After you agree to the prompt, the current upstream databases and files will be downloaded.
- Optionally use
ddev push upsunto push local files and database to Upsun. The
ddev pushcommand can potentially damage your production site, so we don’t recommend using it.
ddev pull upsunwill connect to Upsun to download database and files. To skip downloading and importing either file or database assets, use the
- If you need to change the
upsun.yamlrecipe, you can change it to suit your needs, but remember to remove the
#ddev-generatedline from the top of the file.