fix: transfer command with proxy support

[dhoko]

Hello 👋

What does it do?

The current version of the command is unable to run inside a CI env with a proxy.

ex:

> strapi transfer --from https://xxxx/admin --exclude files --from-token [MASKED] --force --verbose
? The transfer will delete all the local Strapi assets and its database. Are you sure you want to proceed? Yes
Config file not loaded, extension must be one of .js,.json): admin.js.map
Config file not loaded, extension must be one of .js,.json): api.js.map
Config file not loaded, extension must be one of .js,.json): database.js.map
Config file not loaded, extension must be one of .js,.json): features.js.map
Config file not loaded, extension must be one of .js,.json): middlewares.js.map
Config file not loaded, extension must be one of .js,.json): plugins.js.map
Config file not loaded, extension must be one of .js,.json): server.js.map
[2025-06-03 09:56:57.796] info: [remote-source-provider] establishing websocket connection
[2025-06-03 09:56:57.799] info: [local-destination-provider] validating options
[2025-06-03 09:56:58.314] info: [local-destination-provider] Rolling back transaction
[2025-06-03 09:56:58.315] info: [local-destination-provider] Rolled back transaction
Transfer process failed.

That's it, nothing else.

Why is it needed?

So we can execute the command inside an env with a proxy, ex a CI job.

How to test it?

Set a proxy, run the transfer it fails. Fixed via sed inside my CI to validate everything.
I also added to my env GLOBAL_AGENT_ENVIRONMENT_VARIABLE_NAMESPACE: '' cf https://www.npmjs.com/package/global-agent#what-is-the-reason-global-agentbootstrap-does-not-use-http_proxy

Now when it fails we will hav a few more informations:

ProviderTransferError
    at WebSocket.<anonymous> (/builds/web/cms/node_modules/@strapi/data-transfer/dist/strapi/providers/utils.js:158:20)
    at Object.onceWrapper (node:events:639:26)
    at WebSocket.emit (node:events:524:28)
    at WebSocket.emit (node:domain:489:12)
    at emitErrorAndClose (/builds/web/cms/node_modules/ws/lib/websocket.js:1035:13)
    at ClientRequest.<anonymous> (/builds/web/cms/node_modules/ws/lib/websocket.js:880:5)
    at ClientRequest.emit (node:events:524:28)
    at ClientRequest.emit (node:domain:489:12)
    at emitErrorEvent (node:_http_client:101:11)
    at TLSSocket.socketErrorListener (node:_http_client:504:5) {
  origin: 'provider',
  severity: 'fatal',
  details: { step: 'transfer', details: { details: [Object] } }
}
{ details: { error: '' } }
Transfer process failed.

To validate it, I have a job inside my CI to execute the command. Before calling it I added:

    - |
      sed -i  "s/await strapi.telemetry.send('didDEITSProcessFail/console.log('MJS');console.error(e);console.error(e?.details?.details);\nawait strapi.telemetry.send('didDEITSProcessFail/"  node_modules/@strapi/strapi/dist/src/cli/commands/transfer/action.mjs

    - |
      sed -i  "s/await strapi.telemetry.send('didDEITSProcessFail/console.error(e);console.log('JS');console.error(e?.details?.details);\nawait strapi.telemetry.send('didDEITSProcessFail/"  node_modules/@strapi/strapi/dist/src/cli/commands/transfer/action.js

    - |
      sed -i  "1i require('global-agent/bootstrap');\n"  node_modules/@strapi/strapi/dist/src/cli/commands/transfer/action.js

    - |
      sed -i  "1i import 'global-agent/bootstrap';\n\n"  node_modules/@strapi/strapi/dist/src/cli/commands/transfer/action.mjs

Related issue(s)/PR(s)

#22755
strapi/documentation#2514

[vercel]

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name	Status	Preview	Comments	Updated (UTC)
contributor-docs	✅ Ready (Inspect)	Visit Preview	💬 Add feedback	Jun 30, 2025 9:00am