diff --git a/.gitlab-ci.yml b/.gitlab-ci.yml
index e22c4531e699fd86c327865bb5a0f57b4fa14af7..f82b455c88ccf132c94486fae035969197d60589 100644
--- a/.gitlab-ci.yml
+++ b/.gitlab-ci.yml
@@ -122,6 +122,8 @@ release_job:
 
 # === Job: Deploy
 # Description: this job creates publishes the package to the gitlab package registry
+# === Variables ===
+# NPM_AUTH_TOKEN: a deploy token with read_package_registry and write_package_registry scopes
 deploy:
   stage: deploy
   needs: ["proxy"]
diff --git a/.yarnrc.yml b/.yarnrc.yml
index 1b2f83f8f6e52fe76292dd8ccfd4ff8dcf23c544..0c5ea3447d30195a346bcdd951831c21a5b79c78 100644
--- a/.yarnrc.yml
+++ b/.yarnrc.yml
@@ -1,12 +1,8 @@
 nodeLinker: node-modules
 
-npmPublishRegistry: "${CI_API_V4_URL:-https://gitlab1.ptb.de/api/v4}/projects/${CI_PROJECT_ID:-105}/packages/npm/"
-
 npmScopes:
   d-ptb:
+    npmPublishRegistry: "${CI_API_V4_URL:-https://gitlab1.ptb.de/api/v4}/projects/${CI_PROJECT_ID:-105}/packages/npm/"
     npmRegistryServer: "${CI_API_V4_URL:-https://gitlab1.ptb.de/api/v4}/packages/npm/"
-
-npmRegistries:
-  "${CI_API_V4_URL:-https://gitlab1.ptb.de/api/v4}/projects/${CI_PROJECT_ID:-105}/packages/npm/":
     npmAlwaysAuth: true
     npmAuthToken: "${NPM_AUTH_TOKEN:-}"