What you see
info There appears to be trouble with your network connection. Retrying...
error An unexpected error occurred: "https://registry.yarnpkg.com/typescript/-/typescript-5.6.3.tgz: ESOCKETTIMEDOUT".Common causes
- The default network timeout of 30 seconds is too short for large tarballs on slow links.
- Many parallel downloads saturating the runner's connection.
- A distant or congested route to the registry.
How to fix it
- 01
Raise the timeout
Give large downloads more time.
shell yarn install --frozen-lockfile --network-timeout 600000 - 02
Lower concurrency
Fewer parallel downloads finish more reliably on a slow link.
shell yarn install --network-concurrency 4 - 03
Download from your region
A registry cache next to the runner removes the slow link for every package already cached.
.npmrc registry=https://acme.cacheport.cc/npm/ //acme.cacheport.cc/npm/:_authToken=${CACHEPORT_TOKEN}