[!WARNING] This repository is no longer maintained by our internal teams.
The template is provided as is and will not receive updates, bug fixes, or new features.
You are welcome to contribute on it or fork the repository and modify it for your own use. To deploy this template on Upsun, you can use the command upsun project:convert on this codebase to convert the existing .platform.app.yaml configuration file to the Upsun Flex format.

<a href="https://www.drupal.org/"> <img src="header.svg"> </a> <h1 align="center">Deploy Drupal 9 on Platform.sh</h1> Contribute, request a feature, or check out our resources <a href="https://community.platform.sh">Join our community</a>&nbsp&nbsp&nbsp&nbsp&nbsp&nbsp <a href="https://docs.platform.sh">Documentation</a>&nbsp&nbsp&nbsp&nbsp&nbsp&nbsp <a href="https://platform.sh/blog">Blog</a>&nbsp&nbsp&nbsp&nbsp&nbsp&nbsp <a href="https://github.com/platformsh-templates/drupal9/issues/new?assignees=&labels=bug&template=bug_report.yml">Report a bug</a>&nbsp&nbsp&nbsp&nbsp&nbsp&nbsp <a href="https://github.com/platformsh-templates/drupal9/issues/new?assignees=&labels=feature+request&template=improvements.yml">Request a feature</a> <a href="https://github.com/platformsh-templates/drupal9/issues"> <img src="https://img.shields.io/github/issues/platformsh-templates/drupal9.svg?style=for-the-badge&labelColor=f4f2f3&color=ffd9d9&label=Issues" alt="Open issues" /> </a>&nbsp&nbsp <a href="https://github.com/platformsh-templates/drupal9/pulls"> <img src="https://img.shields.io/github/issues-pr/platformsh-templates/drupal9.svg?style=for-the-badge&labelColor=f4f2f3&color=ffd9d9&label=Pull%20requests" alt="Open PRs" /> </a>&nbsp&nbsp <a href="https://github.com/platformsh-templates/drupal9/blob/master/LICENSE"> <img src="https://img.shields.io/static/v1?label=License&message=MIT&style=for-the-badge&labelColor=f4f2f3&color=ffd9d9" alt="License" /> </a> <hr> Contents <a href="#about">About</a>&nbsp&nbsp&nbsp&nbsp&nbsp&nbsp <a href="#getting-started">Getting started</a>&nbsp&nbsp&nbsp&nbsp&nbsp&nbsp <a href="#migrate">Migrate</a>&nbsp&nbsp&nbsp&nbsp&nbsp&nbsp <a href="#learn">Learn</a>&nbsp&nbsp&nbsp&nbsp&nbsp&nbsp <a href="#contribute">Contribute</a>&nbsp&nbsp&nbsp&nbsp&nbsp&nbsp <hr>

About

This template builds Drupal 9 using the "Drupal Recommended" Composer project. It is pre-configured to use MariaDB and Redis for caching. The Drupal installer will skip asking for database credentials as they are already provided.

Drupal is a flexible and extensible PHP-based CMS framework.

Features

PHP 8.1
MariaDB 10.4
Redis 6
Drush included
Automatic TLS certificates
Composer-based build

Getting started

Deploy

Quickstart

You can quickly recreate this project locally with the following command:

composer create-project platformsh/drupal9 -s dev

Note:

Platform.sh templates prioritize upstream release versions over our own. Despite this, we update template dependencies on a scheduled basis independent of those upstreams. Because of this, template repos do not contain releases. This may change in the future, but until then the -s dev flag is necessary to use composer create-project.

Other deployment options

For all of the other options below, clone this repository first:

git clone https://github.com/platformsh-templates/drupal9

If you're trying to deploy from GitHub, you can generate a copy of this repository first in your own namespace by clicking the Use this template button at the top of this page.

Then you can clone a copy of it locally with git clone git@github.com:YOUR_NAMESPACE/drupal9.git.

<details> <summary>Deploy directly to Platform.sh from the command line</summary>

Create a free trial:

Register for a 30 day free trial with Platform.sh. When you have completed signup, select the Create from scratch project option. Give you project a name, and select a region where you would like it to be deployed. As for the Production environment option, make sure to match it to this repository's settings, or to what you have updated the default branch to locally.
Install the Platform.sh CLI

Follow the instructions to install the Platform.sh CLI for your operating system. You can verify the installation by logging in (platformsh login) and listing your projects (platform project:list).

Set the project remote

Find your PROJECT_ID by running the command platform project:list

+---------------+------------------------------------+------------------+---------------------------------+
| ID            | Title                              | Region           | Organization                    |
+---------------+------------------------------------+------------------+---------------------------------+
| PROJECT_ID    | Your Project Name                  | xx-5.platform.sh | your-username                   |
+---------------+------------------------------------+------------------+---------------------------------+

Then from within your local copy, run the command platform project:set-remote PROJECT_ID.

Push
```
git push platform DEFAULT_BRANCH
```

</details> <details> <summary>Integrate with a GitHub repo and deploy pull requests</summary>

Create a free trial:

Register for a 30 day free trial with Platform.sh. When you have completed signup, select the Create from scratch project option. Give you project a name, and select a region where you would like it to be deployed. As for the Production environment option, make sure to match it to whatever you have set at https://YOUR_NAMESPACE/nextjs-drupal.
Install the Platform.sh CLI

Follow the instructions to install the Platform.sh CLI for your operating system. You can verify the installation by logging in (platformsh login) and listing your projects (platform project:list).
Setup the integration:

Consult the GitHub integration documentation to finish connecting your repository to a project on Platform.sh. You will need to create an Access token on GitHub to do so.

</details> <details> <summary>Integrate with a GitLab repo and deploy merge requests</summary>

Create a free trial:

Register for a 30 day free trial with Platform.sh. When you have completed signup, select the Create from scratch project option. Give you project a name, and select a region where you would like it to be deployed. As for the Production environment option, make sure to match it to this repository's settings, or to what you have updated the default branch to locally.
Install the Platform.sh CLI

Follow the instructions to install the Platform.sh CLI for your operating system. You can verify the installation by logging in (platformsh login) and listing your projects (platform project:list).
Create the repository

Create a new repository on GitLab, set it as a new remote for your local copy, and push to the default branch.
Setup the integration:

Consult the GitLab integration documentation to finish connecting a repository to a project on Platform.sh. You will need to create an Access token on GitLab to do so.

</details> <details> <summary>Integrate with a Bitbucket repo and deploy pull requests</summary>

Create a free trial:

Register for a 30 day free trial with Platform.sh. When you have completed signup, select the Create from scratch project option. Give you project a name, and select a region where you would like it to be deployed. As for the Production environment option, make sure to match it to this repository's settings, or to what you have updated the default branch to locally.
Install the Platform.sh CLI

Follow the instructions to install the Platform.sh CLI for your operating system. You can verify the installation by logging in (platformsh login) and listing your projects (platform project:list).
Create the repository

Create a new repository on Bitbucket, set it as a new remote for your local copy, and push to the default branch.
Setup the integration:

Consult the Bitbucket integration documentation to finish connecting a repository to a project on Platform.sh. You will need to create an Access token on Bitbucket to do so.

</details>

Post-install

Run through the Drupal installer as normal. You will not be asked for database credentials as those are already provided.

Local development

This section provides instructions for running the drupal9 template locally, connect

Drupal9

Install / Use

README