The source code of your project will reside in a git-based VCS repository. You can start with a plain project, however we suggest starting with a fork of the shopware/paas setup template from GitHub. You will find out more about the setup template in the Setup Template section.
This guide explains the repository setup using GitHub. You can also integrate Bitbucket or GitLab based version control environments with Shopware PaaS. More information in Source Integrations.

Fork and clone setup template

First of all create a new fork of the shopware/paas setup template.
Screenshot of the fork button on GitHub
In the next step, clone it to your local machine (the following commands require git command line tools):
git clone <path-to-your-fork> shopware-cloud-project
This will create a local copy of the forked repository in a directory named shopware-cloud-project.

Add an upstream remote

Have a look at the remotes using git remote -v. By default, your repository is configured with a remote named origin which points to your forked repository. However, we also want to ensure you can receive updates whenever Shopware makes changes to the setup repository. Hence, we configure a so-called upstream remote:
git remote add upstream
If you run git remote -v again, you will see that there's a new remote named upstream. From now on, you can always pull the latest changes from the official template using
git fetch upstream
git checkout main # Assuming your default branch is called "main"
git merge upstream/main
Be aware that you might have to resolve some conflicts if you made changes in your template.

Add PaaS remote

Next, we need to add a third remote, which allows us to push code towards the PaaS environment and trigger a deployment.
We first need the project ID, so we display all projects using
$ shopware projects
Your projects are:
| ID | Title | Region | Organization |
| 7xasjkyld189e | paas-env | <region-domain> | shopware |
Get a project by running: platform get [id]
List a projects environments by running: platform environments -p [id]
To add the project remote to your local repository, just run
shopware project:set-remote 7xasjkyld189e # Replace with your project ID


Now your repository is configured - you should have three remotes
$ git remote -v
origin [email protected]:<project-repository>.git (fetch)
origin [email protected]:<project-repository>.git (push)
platform <paas-url>.git (fetch)
platform <paas-url>.git (push)
upstream (fetch)
upstream (push)
Project Code
This remote contains all your project specific source code
PaaS Environment
Changes pushed to this remote will be synced with your PaaS environment
Official Template
Maintained by Showpare and used to pull latest changes
Copy link
Edit on GitHub
On this page
Fork and clone setup template
Add an upstream remote
Add PaaS remote