{"record":{"id":"64979d0e96261e5d","repo":"MagicMirrorOrg/MagicMirror","slug":"warning-your-config-is-using-deprecated-option-s","errorCode":null,"errorMessage":"WARNING! Your config is using deprecated option(s): ${usedDeprecated.join(\", \")}. Check README and Documentation for more up-to-date ways of getting the same functionality.","messagePattern":"WARNING! Your config is using deprecated option\\(s\\): (.+?)\\. Check README and Documentation for more up-to-date ways of getting the same functionality\\.","errorType":"console","errorClass":null,"httpStatus":null,"severity":"warning","filePath":"js/utils.js","lineNumber":83,"sourceCode":"\t\t}\n\t}\n\t// return the list to the caller\n\treturn modulePositions;\n};\n\n/**\n * Checks the config for deprecated options and throws a warning in the logs\n * if it encounters one option from the deprecated.js list\n * @param {object} userConfig The user config\n */\nconst checkDeprecatedOptions = (userConfig) => {\n\tconst deprecated = require(`${global.root_path}/js/deprecated`);\n\n\t// check for deprecated core options\n\tconst deprecatedOptions = deprecated.configs;\n\tconst usedDeprecated = deprecatedOptions.filter((option) => userConfig.hasOwnProperty(option));\n\tif (usedDeprecated.length > 0) {\n\t\tLog.warn(`WARNING! Your config is using deprecated option(s): ${usedDeprecated.join(\", \")}. Check README and Documentation for more up-to-date ways of getting the same functionality.`);\n\t}\n\n\t// check for deprecated module options\n\tfor (const element of userConfig.modules) {\n\t\tif (deprecated[element.module] !== undefined && element.config !== undefined) {\n\t\t\tconst deprecatedModuleOptions = deprecated[element.module];\n\t\t\tconst usedDeprecatedModuleOptions = deprecatedModuleOptions.filter((option) => element.config.hasOwnProperty(option));\n\t\t\tif (usedDeprecatedModuleOptions.length > 0) {\n\t\t\t\tLog.warn(`WARNING! Your config for module ${element.module} is using deprecated option(s): ${usedDeprecatedModuleOptions.join(\", \")}. Check README and Documentation for more up-to-date ways of getting the same functionality.`);\n\t\t\t}\n\t\t}\n\t}\n};\n\n/**\n * Loads the config file. Combines it with the defaults and returns the config\n * @returns {object} an object holding full and redacted config\n */","sourceCodeStart":65,"sourceCodeEnd":101,"githubUrl":"https://github.com/MagicMirrorOrg/MagicMirror/blob/4b4a59534f7da01e4030e46029fe9dd649a7675e/js/utils.js#L65-L101","documentation":"checkDeprecatedOptions scans the user's top-level config against the list in js/deprecated.js. Any core option present that has been deprecated triggers this warning so users migrate before removal. It does not stop the server; the option may already be ignored.","triggerScenarios":"Config.js contains an option listed in deprecated.configs (e.g. old kioskmode/ addressing options or renamed settings) after a MagicMirror upgrade.","commonSituations":"Upgrading MagicMirror from an older release and keeping an old config.js; copying tutorial configs written for previous versions.","solutions":["Read the message to see exactly which option names are flagged.","Consult the MagicMirror changelog/documentation for the replacement option or module for each deprecated key.","Remove or replace the deprecated keys in config.js and restart."],"exampleFix":"// before\n{ address: \"0.0.0.0\", port: 8080, ipWhitelist: [...] }\n// after (address deprecated in favor of bind address handling in newer versions)\n{ port: 8080, address: \"0.0.0.0\", ipWhitelist: [...] } // follow the changelog entry for the exact replacement","handlingStrategy":"validation","validationCode":"// check your config against the deprecation list:\nconst deprecated = require(\"./js/deprecated\");\nconst used = deprecated.configs.filter((o) => config.hasOwnProperty(o));\nif (used.length) console.error(\"Replace deprecated core options:\", used);","typeGuard":null,"tryCatchPattern":null,"preventionTips":["Run `npm run config:check` after every core upgrade","Read the changelog when upgrading MagicMirror","Keep a minimal config.js and add options only when documented as current","Search the docs for replacement options instead of copying old configs"],"tags":["config","deprecation"],"backgroundTag":"deprecated-config-option","analyzedSha":"4b4a59534f7da01e4030e46029fe9dd649a7675e","analyzedAt":"2026-08-31T21:49:42.591Z","schemaVersion":2},"datasetVersion":"2026-08-31T22:30:34.772Z"}