Skip to main content

Note

Before you start, check out the Upsun demo app and the main Getting started guide. They provide all of the core concepts and common commands you need to know before using the materials below.
It should also be noted that this guide works for the following variations of Drupal:
For Drupal to successfully deploy and operate, after completing the Getting started guide, you still need to make a few changes to your Upsun configuration. In addition to the above, you should also have:

Configure

Open the .upsun/config.yaml file that’s been generated and replace with the following: This configuration is similar to the deployment process for Drupal on Upsun Fixed, however it is slightly updated for Upsun’s configuration.

Variables

The project:init command created a .environment file containing environment variables for the two services (MariaDB and Redis). Now append the following Drush configuration to the bottom of that file:
.environment

settings.php

Open web/sites/default/settings.php and append the following to the bottom of that file.
web/sites/default/settings.php

Upsun-specific settings

Then create a new Upsun-specific settings file web/sites/default/settings.upsun.php which should contain the following:
web/sites/default/settings.upsun.php

config/sync

Create the config/sync empty directory referenced in the settings file:
Terminal

Deploy changes

Now commit all of the above changes and push to Upsun.
Terminal

Snippets

You can also find all the snippets described in this post on GitHub

Further resources

Documentation

Community content

Blogs

Last modified on March 18, 2026