import Intro from '/docs/snippets/breaking-change-page-intro.md'
import MigrationIntro from '/docs/snippets/breaking-change-page-migration-intro.md'

Server proxy configurations are grouped under the server.proxy object#

In Strapi 5, all proxy configuration options are consolidated under the server.proxy object in /config/server.js|ts, replacing separate server.globalProxy and server.proxy options from v4.

In Strapi 5, all proxy configuration options are now configured through the server.proxy object in /config/server.js|ts, whether they are for requests made within strapi.fetch or for the global proxy agent for the server.

Breaking change description#

In Strapi v4

• server.globalProxy is used to configure all requests through strapi.fetch.
• server.proxy is used to set the value of koa server’s proxy option.

In Strapi 5

All configuration options are grouped under the server.proxy object.

Migration#

Notes#

Additional information about how the server.proxy configuration works in Strapi 5 is available in the server configuration documentation.

Manual migration#

Users will need to manually update the code:

• If server.proxy is used, it needs to move to server.proxy.koa.

• If server.globalProxy is used, you have 2 choices:

  • move it to server.proxy.global and be aware that it will now work for HTTP/HTTPS requests in addition to strapi.fetch requests,
  • or move it to server.proxy.fetch to keep the exact same functionality as in Strapi v4, where only fetch was proxied.