From feda0d16bd4c518057bb0e58c546a576f2809bab Mon Sep 17 00:00:00 2001
From: "github-action[bot]" <>
Date: Wed, 16 Sep 2026 13:55:54 +0000
Subject: [PATCH] Update Flex endpoint

---
 RECIPES.md                                    |   1 +
 ...466bc7861d30c0b1f128d8dc226e0efa3b5e6.json | 149 ++++++++++++++++++
 fyrst.shopware-cd.1.0.json                    | 149 ++++++++++++++++++
 index.json                                    |   3 +
 4 files changed, 302 insertions(+)
 create mode 100644 archived/fyrst.shopware-cd/b31466bc7861d30c0b1f128d8dc226e0efa3b5e6.json
 create mode 100644 fyrst.shopware-cd.1.0.json

diff --git a/RECIPES.md b/RECIPES.md
index e5a9ed8f..a6354b8d 100644
--- a/RECIPES.md
+++ b/RECIPES.md
@@ -248,6 +248,7 @@ Additional recipes can be found on the [Main Recipes Repository](https://github.
 | [friendsofsymfony/oauth-server-bundle](https://packagist.org/packages/friendsofsymfony/oauth-server-bundle) | [1.6](../../../tree/main/friendsofsymfony/oauth-server-bundle/1.6) |
 | [friendsofsymfony/rest-bundle](https://packagist.org/packages/friendsofsymfony/rest-bundle) | [3.0](../../../tree/main/friendsofsymfony/rest-bundle/3.0) |
 | [fsi/files](https://packagist.org/packages/fsi/files) | [1.5](../../../tree/main/fsi/files/1.5) |
+| [fyrst/shopware-cd](https://packagist.org/packages/fyrst/shopware-cd) | [1.0](../../../tree/main/fyrst/shopware-cd/1.0) |
 | [galactic-shrine/gsid](https://packagist.org/packages/galactic-shrine/gsid) | [2.0](../../../tree/main/galactic-shrine/gsid/2.0) |
 | [gearsite/api](https://packagist.org/packages/gearsite/api) | [1.0](../../../tree/main/gearsite/api/1.0) |
 | [geekybones/fraud-defense-bundle](https://packagist.org/packages/geekybones/fraud-defense-bundle) | [1.0](../../../tree/main/geekybones/fraud-defense-bundle/1.0) |
diff --git a/archived/fyrst.shopware-cd/b31466bc7861d30c0b1f128d8dc226e0efa3b5e6.json b/archived/fyrst.shopware-cd/b31466bc7861d30c0b1f128d8dc226e0efa3b5e6.json
new file mode 100644
index 00000000..e107b888
--- /dev/null
+++ b/archived/fyrst.shopware-cd/b31466bc7861d30c0b1f128d8dc226e0efa3b5e6.json
@@ -0,0 +1,149 @@
+{
+    "manifests": {
+        "fyrst/shopware-cd": {
+            "manifest": {
+                "copy-from-package": {
+                    "overlay/": ""
+                },
+                "bundles": {
+                    "Fyrst\\ShopwareCd\\FyrstShopwareCdBundle": [
+                        "all"
+                    ]
+                },
+                "env": {
+                    "SHOPWARE_SHOP_ID": "",
+                    "SHOPWARE_DEPLOY_ENV": "live",
+                    "SHOPWARE_DATA_BASE": "/var/lib/shopware/data"
+                },
+                "post-install-output": [
+                    "  * <fg=blue>fyrst/shopware-cd</>",
+                    "    Flex copied CD files from the package",
+                    "    <comment>overlay/</comment> into the shop root: CI,",
+                    "    <comment>deploy/</comment> (including CD Compose), <comment>.dockerignore</comment>,",
+                    "    and <comment>.env.example</comment>",
+                    "    (same idea as <comment>shopware/docker</comment> copying <comment>docker/Dockerfile</comment>).",
+                    "",
+                    "    <comment>compose.yaml</comment>, <comment>.gitignore</comment>, and",
+                    "    <comment>.shopware-project.yml</comment> (create\u2019s default;",
+                    "    <comment>.shopware-project.yaml</comment> is also accepted \u2014 do not rename)",
+                    "    are owned by",
+                    "    <comment>shopware-cli project create</comment> / the CLI \u2014 not this recipe.",
+                    "",
+                    "    Local: <comment>shopware-cli project dev</comment> and the CLI-managed",
+                    "    shop-root <comment>compose.yaml</comment>.",
+                    "    VPS/CD: files under <comment>deploy/</comment>",
+                    "    (<comment>deploy/compose.yaml</comment>, <comment>deploy/compose.prod.yaml</comment>,",
+                    "    <comment>deploy/compose.vps.yaml</comment>).",
+                    "    Runtime DB/bind-mount copy between VPS hosts:",
+                    "    <comment>fyrst-cli shopware sync pull</comment>",
+                    "    (see <comment>deploy/sync-runtime.md</comment>).",
+                    "    DB snapshots use <comment>shopware-cli project dump</comment>",
+                    "    (fyrst-cli never dumps; restore is",
+                    "    <comment>fyrst-cli shopware db import</comment>).",
+                    "    Live backups (not sync):",
+                    "    <comment>fyrst-cli shopware backup create</comment>",
+                    "    (see <comment>deploy/backup-runtime.md</comment>).",
+                    "    Rollback:",
+                    "    <comment>IMAGE_TAG=$(cat .previous-tag) fyrst-cli shopware deploy rollback</comment>.",
+                    "    Each VPS needs <comment>fyrst-cli</comment> 0.1.0+",
+                    "    (<comment>https://github.com/fyrst-dev/cli</comment>).",
+                    "    CI runs <comment>fyrst-cli shopware deploy release</comment>",
+                    "    with <comment>IMAGE</comment> / <comment>IMAGE_TAG</comment> /",
+                    "    <comment>COMPOSE_DIR</comment>.",
+                    "    TLS edge: <comment>deploy/edge/Caddyfile</comment>.",
+                    "    Live \u2192 local project dev rsync (no DB):",
+                    "    <comment>fyrst-cli shopware sync local</comment>",
+                    "    (reads <comment>SHOPWARE_SHOP_ID</comment> from local <comment>.env</comment>;",
+                    "    remote root <comment>/var/lib/shopware/data/${SHOPWARE_SHOP_ID}/live</comment>;",
+                    "    <comment>--data all</comment> is refused).",
+                    "",
+                    "    Flex may append a <comment>###> fyrst/shopware-cd ###</comment>",
+                    "    block to shop-root <comment>.env</comment> (empty",
+                    "    <comment>SHOPWARE_SHOP_ID</comment>, <comment>SHOPWARE_DEPLOY_ENV=live</comment>,",
+                    "    <comment>SHOPWARE_DATA_BASE=/var/lib/shopware/data</comment>).",
+                    "    It does not overwrite create\u2019s whole <comment>.env</comment>",
+                    "    and does not put secrets in that block. Then run",
+                    "    <comment>fyrst-cli shopware env init --shop-id \u2026</comment>",
+                    "    (see <comment>deploy/README</comment>).",
+                    "    VPS <comment>.env</comment> source of truth (required):",
+                    "    <comment>SHOPWARE_SHOP_ID</comment> (same slug on live + staging + laptop),",
+                    "    <comment>SHOPWARE_DEPLOY_ENV</comment> (live|staging|playground|dev).",
+                    "    Compose derives project name",
+                    "    (<comment>${SHOPWARE_SHOP_ID}-${SHOPWARE_DEPLOY_ENV}</comment>)",
+                    "    and bind-mount paths from those two plus optional",
+                    "    <comment>SHOPWARE_DATA_BASE</comment> (default",
+                    "    <comment>/var/lib/shopware/data</comment>) \u2014 three separate interpolations,",
+                    "    no nested defaults. It does not require",
+                    "    <comment>COMPOSE_PROJECT_NAME</comment> or <comment>SHOPWARE_DATA_ROOT</comment>",
+                    "    (optional for scripts/docs; fyrst-cli derives when unset and prefers them",
+                    "    when set \u2014 do not assign them empty).",
+                    "    WARNING: <comment>shopware-cli project create</comment> writes",
+                    "    <comment>COMPOSE_PROJECT_NAME=sw-shop-\u2026</comment> into shop-root",
+                    "    <comment>.env</comment> for local <comment>project dev</comment>. That env var",
+                    "    overrides Compose <comment>name:</comment>",
+                    "    (<comment>${SHOPWARE_SHOP_ID}-${SHOPWARE_DEPLOY_ENV}</comment>).",
+                    "    On the VPS, comment out that line",
+                    "    (<comment>fyrst-cli shopware env init --vps</comment> or by hand).",
+                    "    Flex does not delete it on <comment>composer require</comment>",
+                    "    (create owns the local flow).",
+                    "    Bootstrap:",
+                    "    <comment>DATA=\"${SHOPWARE_DATA_BASE:-/var/lib/shopware/data}/${SHOPWARE_SHOP_ID}/${SHOPWARE_DEPLOY_ENV}\"</comment>",
+                    "    then <comment>mkdir -p \"${DATA}\"/{files,media,thumbnail,theme,sitemap}</comment>",
+                    "    then <comment>chown -R 82:82 \"${DATA}\"</comment>.",
+                    "    Live profiles: uncomment",
+                    "    <comment>COMPOSE_PROFILES=redis,worker,scheduler</comment>",
+                    "    in <comment>.env</comment> (worker + scheduler; redis if used). Staging leaves",
+                    "    this unset unless you need async tasks.",
+                    "    <comment>fyrst-cli shopware deploy release</comment> warns on live when it is empty; it does",
+                    "    not auto-enable.",
+                    "    Same-host tag-and-load / air-gap: <comment>PULL_POLICY=never</comment>",
+                    "    and <comment>SKIP_PULL=1</comment> (or",
+                    "    <comment>fyrst-cli shopware deploy release --skip-pull</comment>). Default",
+                    "    <comment>pull_policy</comment> is <comment>always</comment> for CI/VPS.",
+                    "    Several shops or live+staging on one VPS share the host; shop id + env",
+                    "    keep stacks isolated.",
+                    "",
+                    "    You MUST require <comment>shopware/docker</comment> in the same Composer command as",
+                    "    this package. That recipe copies <comment>docker/Dockerfile</comment>, which CI and",
+                    "    CD Compose require (default <comment>DOCKERFILE=docker/Dockerfile</comment>). This recipe",
+                    "    does not ship a root Dockerfile. A missing <comment>docker/Dockerfile</comment>",
+                    "    means <comment>shopware/docker</comment> was skipped.",
+                    "",
+                    "    Flex may append SoT keys to <comment>.env</comment>; it does not",
+                    "    overwrite create\u2019s whole <comment>.env</comment>. Then run",
+                    "    <comment>fyrst-cli shopware env init --shop-id \u2026</comment>",
+                    "    (VPS: add <comment>--vps</comment>; see <comment>deploy/README</comment>).",
+                    "    If <comment>.env</comment> is missing, that command copies",
+                    "    <comment>.env.example</comment> first. Commit the copied files;",
+                    "    <comment>vendor/</comment> is gitignored.",
+                    "",
+                    "    shopware-cli project create writes <comment>.shopware-project.yml</comment>",
+                    "    (that extension is fine). shopware-cli accepts both",
+                    "    <comment>.yml</comment> and <comment>.yaml</comment>; do not rename.",
+                    "    GitHub Actions picks up",
+                    "    <comment>.github/workflows/cd.yaml</comment>. GitLab still defaults to",
+                    "    <comment>.gitlab-ci.yml</comment>: set Settings \u2192 CI/CD \u2192 CI/CD configuration file",
+                    "    to <comment>.gitlab-ci.yaml</comment> (or copy/symlink that name).",
+                    "",
+                    "    Flex registers",
+                    "    <comment>Fyrst\\ShopwareCd\\FyrstShopwareCdBundle</comment>",
+                    "    in <comment>config/bundles.php</comment>.",
+                    "    Post-restore sales-channel URL rewrite uses",
+                    "    <comment>APP_URL</comment> in shop-root <comment>.env</comment>;",
+                    "    sync calls",
+                    "    <comment>bin/console fyrst:sales-channel:rewrite-urls</comment>.",
+                    "    Laptop SSH (<comment>SHOPWARE_SSH_*</comment>) belongs in",
+                    "    <comment>.env.local</comment>.",
+                    "    Shops need <comment>composer update fyrst/shopware-cd</comment>",
+                    "    so the command and bundle exist, then",
+                    "    <comment>composer recipes:update fyrst/shopware-cd</comment>.",
+                    "",
+                    "    Refresh later with <comment>composer recipes:update fyrst/shopware-cd</comment>.",
+                    "    See https://github.com/fyrst-dev/shopware-cd"
+                ]
+            },
+            "files": [],
+            "ref": "b31466bc7861d30c0b1f128d8dc226e0efa3b5e6"
+        }
+    }
+}
diff --git a/fyrst.shopware-cd.1.0.json b/fyrst.shopware-cd.1.0.json
new file mode 100644
index 00000000..e107b888
--- /dev/null
+++ b/fyrst.shopware-cd.1.0.json
@@ -0,0 +1,149 @@
+{
+    "manifests": {
+        "fyrst/shopware-cd": {
+            "manifest": {
+                "copy-from-package": {
+                    "overlay/": ""
+                },
+                "bundles": {
+                    "Fyrst\\ShopwareCd\\FyrstShopwareCdBundle": [
+                        "all"
+                    ]
+                },
+                "env": {
+                    "SHOPWARE_SHOP_ID": "",
+                    "SHOPWARE_DEPLOY_ENV": "live",
+                    "SHOPWARE_DATA_BASE": "/var/lib/shopware/data"
+                },
+                "post-install-output": [
+                    "  * <fg=blue>fyrst/shopware-cd</>",
+                    "    Flex copied CD files from the package",
+                    "    <comment>overlay/</comment> into the shop root: CI,",
+                    "    <comment>deploy/</comment> (including CD Compose), <comment>.dockerignore</comment>,",
+                    "    and <comment>.env.example</comment>",
+                    "    (same idea as <comment>shopware/docker</comment> copying <comment>docker/Dockerfile</comment>).",
+                    "",
+                    "    <comment>compose.yaml</comment>, <comment>.gitignore</comment>, and",
+                    "    <comment>.shopware-project.yml</comment> (create\u2019s default;",
+                    "    <comment>.shopware-project.yaml</comment> is also accepted \u2014 do not rename)",
+                    "    are owned by",
+                    "    <comment>shopware-cli project create</comment> / the CLI \u2014 not this recipe.",
+                    "",
+                    "    Local: <comment>shopware-cli project dev</comment> and the CLI-managed",
+                    "    shop-root <comment>compose.yaml</comment>.",
+                    "    VPS/CD: files under <comment>deploy/</comment>",
+                    "    (<comment>deploy/compose.yaml</comment>, <comment>deploy/compose.prod.yaml</comment>,",
+                    "    <comment>deploy/compose.vps.yaml</comment>).",
+                    "    Runtime DB/bind-mount copy between VPS hosts:",
+                    "    <comment>fyrst-cli shopware sync pull</comment>",
+                    "    (see <comment>deploy/sync-runtime.md</comment>).",
+                    "    DB snapshots use <comment>shopware-cli project dump</comment>",
+                    "    (fyrst-cli never dumps; restore is",
+                    "    <comment>fyrst-cli shopware db import</comment>).",
+                    "    Live backups (not sync):",
+                    "    <comment>fyrst-cli shopware backup create</comment>",
+                    "    (see <comment>deploy/backup-runtime.md</comment>).",
+                    "    Rollback:",
+                    "    <comment>IMAGE_TAG=$(cat .previous-tag) fyrst-cli shopware deploy rollback</comment>.",
+                    "    Each VPS needs <comment>fyrst-cli</comment> 0.1.0+",
+                    "    (<comment>https://github.com/fyrst-dev/cli</comment>).",
+                    "    CI runs <comment>fyrst-cli shopware deploy release</comment>",
+                    "    with <comment>IMAGE</comment> / <comment>IMAGE_TAG</comment> /",
+                    "    <comment>COMPOSE_DIR</comment>.",
+                    "    TLS edge: <comment>deploy/edge/Caddyfile</comment>.",
+                    "    Live \u2192 local project dev rsync (no DB):",
+                    "    <comment>fyrst-cli shopware sync local</comment>",
+                    "    (reads <comment>SHOPWARE_SHOP_ID</comment> from local <comment>.env</comment>;",
+                    "    remote root <comment>/var/lib/shopware/data/${SHOPWARE_SHOP_ID}/live</comment>;",
+                    "    <comment>--data all</comment> is refused).",
+                    "",
+                    "    Flex may append a <comment>###> fyrst/shopware-cd ###</comment>",
+                    "    block to shop-root <comment>.env</comment> (empty",
+                    "    <comment>SHOPWARE_SHOP_ID</comment>, <comment>SHOPWARE_DEPLOY_ENV=live</comment>,",
+                    "    <comment>SHOPWARE_DATA_BASE=/var/lib/shopware/data</comment>).",
+                    "    It does not overwrite create\u2019s whole <comment>.env</comment>",
+                    "    and does not put secrets in that block. Then run",
+                    "    <comment>fyrst-cli shopware env init --shop-id \u2026</comment>",
+                    "    (see <comment>deploy/README</comment>).",
+                    "    VPS <comment>.env</comment> source of truth (required):",
+                    "    <comment>SHOPWARE_SHOP_ID</comment> (same slug on live + staging + laptop),",
+                    "    <comment>SHOPWARE_DEPLOY_ENV</comment> (live|staging|playground|dev).",
+                    "    Compose derives project name",
+                    "    (<comment>${SHOPWARE_SHOP_ID}-${SHOPWARE_DEPLOY_ENV}</comment>)",
+                    "    and bind-mount paths from those two plus optional",
+                    "    <comment>SHOPWARE_DATA_BASE</comment> (default",
+                    "    <comment>/var/lib/shopware/data</comment>) \u2014 three separate interpolations,",
+                    "    no nested defaults. It does not require",
+                    "    <comment>COMPOSE_PROJECT_NAME</comment> or <comment>SHOPWARE_DATA_ROOT</comment>",
+                    "    (optional for scripts/docs; fyrst-cli derives when unset and prefers them",
+                    "    when set \u2014 do not assign them empty).",
+                    "    WARNING: <comment>shopware-cli project create</comment> writes",
+                    "    <comment>COMPOSE_PROJECT_NAME=sw-shop-\u2026</comment> into shop-root",
+                    "    <comment>.env</comment> for local <comment>project dev</comment>. That env var",
+                    "    overrides Compose <comment>name:</comment>",
+                    "    (<comment>${SHOPWARE_SHOP_ID}-${SHOPWARE_DEPLOY_ENV}</comment>).",
+                    "    On the VPS, comment out that line",
+                    "    (<comment>fyrst-cli shopware env init --vps</comment> or by hand).",
+                    "    Flex does not delete it on <comment>composer require</comment>",
+                    "    (create owns the local flow).",
+                    "    Bootstrap:",
+                    "    <comment>DATA=\"${SHOPWARE_DATA_BASE:-/var/lib/shopware/data}/${SHOPWARE_SHOP_ID}/${SHOPWARE_DEPLOY_ENV}\"</comment>",
+                    "    then <comment>mkdir -p \"${DATA}\"/{files,media,thumbnail,theme,sitemap}</comment>",
+                    "    then <comment>chown -R 82:82 \"${DATA}\"</comment>.",
+                    "    Live profiles: uncomment",
+                    "    <comment>COMPOSE_PROFILES=redis,worker,scheduler</comment>",
+                    "    in <comment>.env</comment> (worker + scheduler; redis if used). Staging leaves",
+                    "    this unset unless you need async tasks.",
+                    "    <comment>fyrst-cli shopware deploy release</comment> warns on live when it is empty; it does",
+                    "    not auto-enable.",
+                    "    Same-host tag-and-load / air-gap: <comment>PULL_POLICY=never</comment>",
+                    "    and <comment>SKIP_PULL=1</comment> (or",
+                    "    <comment>fyrst-cli shopware deploy release --skip-pull</comment>). Default",
+                    "    <comment>pull_policy</comment> is <comment>always</comment> for CI/VPS.",
+                    "    Several shops or live+staging on one VPS share the host; shop id + env",
+                    "    keep stacks isolated.",
+                    "",
+                    "    You MUST require <comment>shopware/docker</comment> in the same Composer command as",
+                    "    this package. That recipe copies <comment>docker/Dockerfile</comment>, which CI and",
+                    "    CD Compose require (default <comment>DOCKERFILE=docker/Dockerfile</comment>). This recipe",
+                    "    does not ship a root Dockerfile. A missing <comment>docker/Dockerfile</comment>",
+                    "    means <comment>shopware/docker</comment> was skipped.",
+                    "",
+                    "    Flex may append SoT keys to <comment>.env</comment>; it does not",
+                    "    overwrite create\u2019s whole <comment>.env</comment>. Then run",
+                    "    <comment>fyrst-cli shopware env init --shop-id \u2026</comment>",
+                    "    (VPS: add <comment>--vps</comment>; see <comment>deploy/README</comment>).",
+                    "    If <comment>.env</comment> is missing, that command copies",
+                    "    <comment>.env.example</comment> first. Commit the copied files;",
+                    "    <comment>vendor/</comment> is gitignored.",
+                    "",
+                    "    shopware-cli project create writes <comment>.shopware-project.yml</comment>",
+                    "    (that extension is fine). shopware-cli accepts both",
+                    "    <comment>.yml</comment> and <comment>.yaml</comment>; do not rename.",
+                    "    GitHub Actions picks up",
+                    "    <comment>.github/workflows/cd.yaml</comment>. GitLab still defaults to",
+                    "    <comment>.gitlab-ci.yml</comment>: set Settings \u2192 CI/CD \u2192 CI/CD configuration file",
+                    "    to <comment>.gitlab-ci.yaml</comment> (or copy/symlink that name).",
+                    "",
+                    "    Flex registers",
+                    "    <comment>Fyrst\\ShopwareCd\\FyrstShopwareCdBundle</comment>",
+                    "    in <comment>config/bundles.php</comment>.",
+                    "    Post-restore sales-channel URL rewrite uses",
+                    "    <comment>APP_URL</comment> in shop-root <comment>.env</comment>;",
+                    "    sync calls",
+                    "    <comment>bin/console fyrst:sales-channel:rewrite-urls</comment>.",
+                    "    Laptop SSH (<comment>SHOPWARE_SSH_*</comment>) belongs in",
+                    "    <comment>.env.local</comment>.",
+                    "    Shops need <comment>composer update fyrst/shopware-cd</comment>",
+                    "    so the command and bundle exist, then",
+                    "    <comment>composer recipes:update fyrst/shopware-cd</comment>.",
+                    "",
+                    "    Refresh later with <comment>composer recipes:update fyrst/shopware-cd</comment>.",
+                    "    See https://github.com/fyrst-dev/shopware-cd"
+                ]
+            },
+            "files": [],
+            "ref": "b31466bc7861d30c0b1f128d8dc226e0efa3b5e6"
+        }
+    }
+}
diff --git a/index.json b/index.json
index 6cf91d39..e6c6098d 100644
--- a/index.json
+++ b/index.json
@@ -782,6 +782,9 @@
         "fsi/files": [
             "1.5"
         ],
+        "fyrst/shopware-cd": [
+            "1.0"
+        ],
         "galactic-shrine/gsid": [
             "1.0",
             "2.0"