# Introduction
# Configuring your MagicMirror
Copy
/home/pi/MagicMirror/config/config.js.sample
to/home/pi/MagicMirror/config/config.js
.
Note: If you used a third-party installer script, this step may already have been done for you.Modify your required settings.
Note: You can check your configuration runningnpm run config:check
in/home/pi/MagicMirror
.
The following properties can be configured:
Option | Description |
---|---|
port | The port on which the MagicMirror² server will run on. The default value is 8080 . |
address | The interface ip address on which to accept connections. The default is localhost , which would prevent exposing the built-in webserver to machines on the local network. To expose it to other machines, use: 0.0.0.0 . |
ipWhitelist | The list of IPs from which you are allowed to access the MagicMirror². The default value is ["127.0.0.1", "::ffff:127.0.0.1", "::1"] , which is from localhost only. Add your IP when needed. You can also specify IP ranges with subnet masks (["127.0.0.1", "127.0.0.1/24"] ) or directly with (["127.0.0.1", ["192.168.0.1", "192.168.0.100"]] ). Set [] to allow all IP addresses. For more information see: follow post ipWhitelist HowTo |
zoom | This allows to scale the mirror contents with a given zoom factor. The default value is 1.0 |
language | The language of the interface. (Note: Not all elements will be localized.) Possible values are en , nl , ru , fr , etc., but the default value is en . |
timeFormat | The form of time notation that will be used. Possible values are 12 or 24 . The default is 24 . |
units | The units that will be used in the default weather modules. Possible values are metric or imperial . The default is metric . |
modules | An array of active modules. The array must contain objects. See module configuration for more information. |
electronOptions | An optional array of Electron (browser) options. This allows configuration of e.g. the browser screen size and position (example: electronOptions: { fullscreen: false, width: 800, height: 600 } ). Kiosk mode can be enabled by setting kiosk: true , autoHideMenuBar: false and fullscreen: false . More options can be found here. |
electronSwitches | An optional array of Electron switches. This allows configuration of electron app itself. This properties will not affect the serveronly mode. Usually normal MM users don't need this property, but if you are a hard-core hacker, you might need this to handle Electron itself over MagicMirror provides. More options can be found here (Not all available switches are described there.)example: electronSwitches:["enable-transparent-visuals", "disable-gpu"]; |
customCss | The path of the custom.css stylesheet. The default is css/custom.css . |