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, 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
    },
  },
});