Docs feedback: yarn needs an additional auth entry to work with the GitLab NPM Registry

I followed the documentation on https://docs.gitlab.com/ee/user/project/packages/npm_registry.html#authenticating-with-an-oauth-token to install a custom package from my companies private repos. This worked really well with npm but with yarn I always ended up with the same error message:

yarn install v1.15.2
warning package.json: No license field
info No lockfile found.
warning XXX: No license field
[1/4] 🔍  Resolving packages...
[2/4] 🚚  Fetching packages...
error An unexpected error occurred: "https://gitlab.com/api/v4/projects/XXX/packages/npm/XXX/XXX/-/XXX/XXX-X.X.X.tgz: Request failed \"404 Not Found\"".
info If you think this is a bug, please open a bug report with the information provided in "/Users/XXX/gitlab-migration/module-util/yarn-error.log".
info Visit https://yarnpkg.com/en/docs/cli/install for documentation about this command

The issue finally went away after I added the line

//gitlab.com/api/v4/projects/:_authToken=<your_oauth_token>

to my .npmrc file. I have no idea why this seems to be required or why it even works but this might be helpful for other users running into the same issue.

mentioned in issue #61160 (closed)

added documentation + 1 deleted label

added typebug label

@axil please let me know if I've tagged you incorrectly in this. I wanted to bring this small documentation issue to your attention.

added 1 deleted label

added to epic &1242 (closed)

Thanks for the feedback @berlwein I'll add this to our backlog for expanding the documentation and user guides.

changed milestone to %Backlog

added [deprecated] Accepting merge requests label

mentioned in issue #61464 (closed)

added priority3 severity3 labels

Thanks for the tip! We should add this to the docs, indeed.

added 1 deleted label and removed 1 deleted label

added devopspackage label and removed 1 deleted label

added Category:Package Registry label

added docs-only label

changed milestone to %12.1

added grouppackage registry label

mentioned in issue gitlab-design#387 (closed)

added OKR FY20 Q2 label

changed milestone to %12.2

assigned to @MattPennaThe3rd

removed [deprecated] Accepting merge requests label

assigned to @marcel.amirault and unassigned @MattPennaThe3rd

mentioned in merge request !31271 (merged)

closed via merge request !31271 (merged)

mentioned in commit 5fd084ec

Is it possible to update the documentation with this gitlab#361608 (comment 937612391) ?

@MinaroShikuchi Do you want to submit a contribution? You can update this file https://gitlab.com/gitlab-org/gitlab/-/tree/master/doc/user/packages/npm_registry and submit an MR. Tag me and I'll help get it triaged.

mentioned in merge request gitlab!86850 (closed)