From 3e5259534c807230b9626e8642fff5a46925dd76 Mon Sep 17 00:00:00 2001 From: Renaud Hager Date: Thu, 29 Jan 2026 17:02:30 +0000 Subject: [PATCH 1/8] feat: Added documentation on how to update Shopware in PaaS Native --- .../paas/shopware/guides/update-shopware.md | 67 +++++++++++++++++++ 1 file changed, 67 insertions(+) create mode 100644 products/paas/shopware/guides/update-shopware.md diff --git a/products/paas/shopware/guides/update-shopware.md b/products/paas/shopware/guides/update-shopware.md new file mode 100644 index 000000000..b8a2592f7 --- /dev/null +++ b/products/paas/shopware/guides/update-shopware.md @@ -0,0 +1,67 @@ +--- +nav: + title: Update Shopware version + position: 40 +--- + +# Guide: Using the Shopware PaaS Vault + +This guide explains how to update Shopware in the PaaS Native context. + +## Pre-requisite +The update should only be started if the latest deploy is successful (state: `DEPLOYING_STORE_SUCCESS`). + +This can be checked with the following command `sw-paas app deploy list`: +``` +sw-paas app deploy list +Selected: shopware +Selected: demo-shop +Found one application: demo-shop +╭────────────────────────────────────┬────────────────────────────────────┬───────────────────────┬────────────────────────────────────┬───────────────────┬───────────────────╮ +│ ID │ BUILD ID │ STATUS │ CREATED BY │ CREATED AT │ APPLIED AT │ +├────────────────────────────────────┼────────────────────────────────────┼───────────────────────┼────────────────────────────────────┼───────────────────┼───────────────────┤ +│2492b221-aea6-46ce-9683-085714b8f0af│85c7246b-f788-11f0-adcf-be3c369299e8│DEPLOYING_STORE_SUCCESS│3324f8f2-20e1-70e2-5dbd-69ca97476cce│22.01.2026 11:51:13│22.01.2026 13:35:07│ +│1ba79041-39a3-4172-bb36-24cd263ff6cc│65d399f4-f067-11f0-b5ac-4eb6c6ab52cb│DEPLOYING_STORE_SUCCESS│93343872-b001-7062-fbba-3a6314e4428d│13.01.2026 10:06:08│22.01.2026 07:32:29│ +│ef58aa25-d303-4b56-b671-cb3918ad75c4│87ea381e-db2b-11f0-a41d-b643c268ee83│DEPLOYING_STORE_SUCCESS│c3446852-f0c1-7095-5131-8d424df937d0│17.12.2025 12:02:57│13.01.2026 08:47:39│ +│3d0ebf52-c0f2-4798-b5ba-05ec01c9cf52│87ea381e-db2b-11f0-a41d-b643c268ee83│DEPLOYING_STORE_SUCCESS│c3446852-f0c1-7095-5131-8d424df937d0│17.12.2025 11:38:03│17.12.2025 11:39:42│ +│a470ee4d-acea-414f-ad6e-54b2e06e97cf│87ea381e-db2b-11f0-a41d-b643c268ee83│DEPLOYING_STORE_SUCCESS│3324f8f2-20e1-70e2-5dbd-69ca97476cce│17.12.2025 09:56:47│17.12.2025 10:00:38│ +│42834c59-c946-4c8e-81e3-62a115ae3fa2│87ea381e-db2b-11f0-a41d-b643c268ee83│DEPLOYING_STORE_SUCCESS│3324f8f2-20e1-70e2-5dbd-69ca97476cce│17.12.2025 09:34:56│17.12.2025 09:40:28│ +│4d12f6c7-301f-4756-9c48-807d18d6d497│4be633d9-db21-11f0-a41d-b643c268ee83│DEPLOYING_STORE_SUCCESS│93343872-b001-7062-fbba-3a6314e4428d│17.12.2025 08:22:01│17.12.2025 08:24:57│ +│2e1e5b43-da0d-4e87-bdfb-a66c42a71a68│d3e822ec-d994-11f0-b2b5-4ec7b4325483│DEPLOYING_STORE_SUCCESS│3324f8f2-20e1-70e2-5dbd-69ca97476cce│15.12.2025 09:03:49│15.12.2025 09:07:25│ +╰────────────────────────────────────┴────────────────────────────────────┴───────────────────────┴────────────────────────────────────┴───────────────────┴───────────────────╯ +``` + +If the state is `DEPLOYING_STORE_FAILED`, you should **NOT** initiate a Shopware update, fix the deployment before trying to anything. + +## Update + +### Preliminary task +It's recommended to do a backup (called `snapshot`) of your application data (database and Shopware filesystem), you can do it with the following command: +``` +sw-paas snapshot create +``` + +Wait until the snapshot is done. + + +### Update the code base +You should proceed as follow: +- Create a new branch: `git checkout -b my-new-branch` +- In `composer.json` udpate `shopware/core` to the new version +- Run `composer update --no-scripts` +- Run `composer recipes:update` +- Commit your changes: `git add . && git commit -m "Updating Shopware to version X.Y.Z"` (keep the commit SHA at hand) +- Push your branch: `git push -u origin my-new-branch` + +Now your code is updated, but it needs to be deployed. + +### Update the running application +Before updating the application you should run then following Shopware command, to prepare the update. +Open an exec session: `sw-paas exec --new`, on your in the session run the following command: `bin/console system:update:prepare`. + +Once this command is done, you can update the application, do the following: `sw-paas application update`. +You can track the progress of the deployment using `sw-paas app deploy list` and/or `sw-paas app deploy get`. + +### Post update task + +Once the application is succesfully updated you tell the system that the update is finished, open a new exec session: `sw-paas exec --new`, then run the following command: `bin/console system:update:finish`. \ No newline at end of file From 03997a70f0f0ba9da71de129e3c6ad238312726d Mon Sep 17 00:00:00 2001 From: Renaud Hager Date: Thu, 29 Jan 2026 17:06:25 +0000 Subject: [PATCH 2/8] Update products/paas/shopware/guides/update-shopware.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- products/paas/shopware/guides/update-shopware.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/products/paas/shopware/guides/update-shopware.md b/products/paas/shopware/guides/update-shopware.md index b8a2592f7..f0a630718 100644 --- a/products/paas/shopware/guides/update-shopware.md +++ b/products/paas/shopware/guides/update-shopware.md @@ -57,7 +57,7 @@ Now your code is updated, but it needs to be deployed. ### Update the running application Before updating the application you should run then following Shopware command, to prepare the update. -Open an exec session: `sw-paas exec --new`, on your in the session run the following command: `bin/console system:update:prepare`. +Open an exec session: `sw-paas exec --new`. Once you're in the session, run the following command: `bin/console system:update:prepare`. Once this command is done, you can update the application, do the following: `sw-paas application update`. You can track the progress of the deployment using `sw-paas app deploy list` and/or `sw-paas app deploy get`. From b7cf7b6ee9a89c8371015975cf81beaf8c00760a Mon Sep 17 00:00:00 2001 From: Renaud Hager Date: Thu, 29 Jan 2026 17:06:37 +0000 Subject: [PATCH 3/8] Update products/paas/shopware/guides/update-shopware.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- products/paas/shopware/guides/update-shopware.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/products/paas/shopware/guides/update-shopware.md b/products/paas/shopware/guides/update-shopware.md index f0a630718..3f1610263 100644 --- a/products/paas/shopware/guides/update-shopware.md +++ b/products/paas/shopware/guides/update-shopware.md @@ -64,4 +64,4 @@ You can track the progress of the deployment using `sw-paas app deploy list` and ### Post update task -Once the application is succesfully updated you tell the system that the update is finished, open a new exec session: `sw-paas exec --new`, then run the following command: `bin/console system:update:finish`. \ No newline at end of file +Once the application is successfully updated you tell the system that the update is finished, open a new exec session: `sw-paas exec --new`, then run the following command: `bin/console system:update:finish`. \ No newline at end of file From 536c4f7c6f8e8b349c160312f3636aecf9feccf6 Mon Sep 17 00:00:00 2001 From: Renaud Hager Date: Thu, 29 Jan 2026 17:07:08 +0000 Subject: [PATCH 4/8] Update products/paas/shopware/guides/update-shopware.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- products/paas/shopware/guides/update-shopware.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/products/paas/shopware/guides/update-shopware.md b/products/paas/shopware/guides/update-shopware.md index 3f1610263..2f75cbaee 100644 --- a/products/paas/shopware/guides/update-shopware.md +++ b/products/paas/shopware/guides/update-shopware.md @@ -31,7 +31,7 @@ Found one application: demo-shop ╰────────────────────────────────────┴────────────────────────────────────┴───────────────────────┴────────────────────────────────────┴───────────────────┴───────────────────╯ ``` -If the state is `DEPLOYING_STORE_FAILED`, you should **NOT** initiate a Shopware update, fix the deployment before trying to anything. +If the state is `DEPLOYING_STORE_FAILED`, you should **NOT** initiate a Shopware update, fix the deployment before trying to do anything. ## Update From b5560c450c1db9737d9ddb425a6a3f9cc36fa1d3 Mon Sep 17 00:00:00 2001 From: Renaud Hager Date: Thu, 29 Jan 2026 17:07:26 +0000 Subject: [PATCH 5/8] Update products/paas/shopware/guides/update-shopware.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- products/paas/shopware/guides/update-shopware.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/products/paas/shopware/guides/update-shopware.md b/products/paas/shopware/guides/update-shopware.md index 2f75cbaee..ff25635f8 100644 --- a/products/paas/shopware/guides/update-shopware.md +++ b/products/paas/shopware/guides/update-shopware.md @@ -4,7 +4,7 @@ nav: position: 40 --- -# Guide: Using the Shopware PaaS Vault +# Guide: Update Shopware version This guide explains how to update Shopware in the PaaS Native context. From bec174b774e8290344ce60cb9831fb42b9d6613b Mon Sep 17 00:00:00 2001 From: Renaud Hager Date: Thu, 29 Jan 2026 17:07:47 +0000 Subject: [PATCH 6/8] Update products/paas/shopware/guides/update-shopware.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- products/paas/shopware/guides/update-shopware.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/products/paas/shopware/guides/update-shopware.md b/products/paas/shopware/guides/update-shopware.md index ff25635f8..e101dd9a2 100644 --- a/products/paas/shopware/guides/update-shopware.md +++ b/products/paas/shopware/guides/update-shopware.md @@ -47,7 +47,7 @@ Wait until the snapshot is done. ### Update the code base You should proceed as follow: - Create a new branch: `git checkout -b my-new-branch` -- In `composer.json` udpate `shopware/core` to the new version +- In `composer.json` update `shopware/core` to the new version - Run `composer update --no-scripts` - Run `composer recipes:update` - Commit your changes: `git add . && git commit -m "Updating Shopware to version X.Y.Z"` (keep the commit SHA at hand) From 3a837a0fa6d713958be123969bc184b3f3faff81 Mon Sep 17 00:00:00 2001 From: Renaud Hager Date: Thu, 29 Jan 2026 17:07:59 +0000 Subject: [PATCH 7/8] Update products/paas/shopware/guides/update-shopware.md Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- products/paas/shopware/guides/update-shopware.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/products/paas/shopware/guides/update-shopware.md b/products/paas/shopware/guides/update-shopware.md index e101dd9a2..053fd1c78 100644 --- a/products/paas/shopware/guides/update-shopware.md +++ b/products/paas/shopware/guides/update-shopware.md @@ -56,7 +56,7 @@ You should proceed as follow: Now your code is updated, but it needs to be deployed. ### Update the running application -Before updating the application you should run then following Shopware command, to prepare the update. +Before updating the application you should run the following Shopware command, to prepare the update. Open an exec session: `sw-paas exec --new`. Once you're in the session, run the following command: `bin/console system:update:prepare`. Once this command is done, you can update the application, do the following: `sw-paas application update`. From 3f43edbc9b183727c0f7c26c3fa3da83bb5d0d87 Mon Sep 17 00:00:00 2001 From: Renaud Hager Date: Thu, 29 Jan 2026 17:09:20 +0000 Subject: [PATCH 8/8] Fixed typo. --- products/paas/shopware/guides/update-shopware.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/products/paas/shopware/guides/update-shopware.md b/products/paas/shopware/guides/update-shopware.md index 053fd1c78..778dc0384 100644 --- a/products/paas/shopware/guides/update-shopware.md +++ b/products/paas/shopware/guides/update-shopware.md @@ -64,4 +64,4 @@ You can track the progress of the deployment using `sw-paas app deploy list` and ### Post update task -Once the application is successfully updated you tell the system that the update is finished, open a new exec session: `sw-paas exec --new`, then run the following command: `bin/console system:update:finish`. \ No newline at end of file +Once the application is successfully updated you can tell the system that the update is finished, open a new exec session: `sw-paas exec --new`, then run the following command: `bin/console system:update:finish`. \ No newline at end of file