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

Some env-only configuration options are handled by the server configuration#

In Strapi 5, three environment variables (STRAPI_DISABLE_REMOTE_DATA_TRANSFER, STRAPI_HIDE_STARTUP_MESSAGE, STRAPI_DISABLE_UPDATE_NOTIFICATION) are now configured via the server configuration file instead of environment variables.

In Strapi 5, some configuration options that were only handled by environment variables in Strapi v4 are now handled in the server configuration file.

Breaking change description#

In Strapi v4

The following list of configurations are only available from the environment:

• STRAPI_DISABLE_REMOTE_DATA_TRANSFER
• STRAPI_DISABLE_UPDATE_NOTIFICATION
• STRAPI_HIDE_STARTUP_MESSAGE

In Strapi 5

These configuration options have been moved to the server configuration file (see table in the notes for details).

Migration#

Notes#

The following environment variable names in Strapi v4 should now be defined in the /config/server.js configuration file:

Migration steps#

If you previously disabled one of the listed environment variables in your environment, update the /config/server.js by adding the appropriate values:

module.exports = ({ env }) => ({
  // … other configuration options
  transfer: {
    remote: {
      enabled: false, // disable remote data transfers instead of STRAPI_DISABLE_REMOTE_DATA_TRANSFER
    },
  },
  logger: {
    updates: {
      enabled: false, // disable update notification logging instead of STRAPI_DISABLE_UPDATE_NOTIFICATION
    },
    startup: {
      enabled: false, // disable startup message instead of STRAPI_HIDE_STARTUP_MESSAGE
    },
  },
});

export default ({ env }) => ({
  // … other configuration options
  transfer: {
    remote: {
      enabled: false, // disable remote data transfers instead of STRAPI_DISABLE_REMOTE_DATA_TRANSFER
    },
  },
  logger: {
    updates: {
      enabled: false, // disable update notification logging instead of STRAPI_DISABLE_UPDATE_NOTIFICATION
    },
    startup: {
      enabled: false, // disable startup message instead of STRAPI_HIDE_STARTUP_MESSAGE
    },
  },
});