Skip to main content

Editing the Configuration

config.js Editor​

  • Open via the file browser
  • Edit directly in the browser

Basic Structure and Key Settings​

let config = {
  address: "0.0.0.0",
  port: 8088,
  ipWhitelist: ["127.0.0.1", "::1", "192.168.1.0/24"],
  language: "en",
  modules: [
    {
      module: "clock",
      position: "top_left"
    },
    {
      module: "newsfeed",
      position: "bottom_bar"
    }
  ]
}

address​

  • Purpose: Defines which network interface MagicMirror² listens on.
  • Recommended value: "0.0.0.0" (you can test editing via pc or laptop)
  • Why: This allows access from other devices in your network. If set to "localhost" or "127.0.0.1", only the mirror itself can access the web interface.

port​

  • Purpose: The port number for the MagicMirror² web server.
  • Default: 8088
  • Important: Do not change this value! The Smart Mirror device and its web interface expect port 8088. Changing it may break connectivity and remote access features.

ipWhitelist​

  • Purpose: Restricts which IP addresses can access the MagicMirror² web interface.
  • Default: Only local addresses (e.g., 127.0.0.1, ::1).
  • How to allow other devices: Add your local network range, e.g., "192.168.1.0/24" for all devices in your home network.
  • Example: 
    ipWhitelist: ["127.0.0.1", "::1", "192.168.1.0/24"]
  • Security Note: Only allow trusted networks. Opening access to "0.0.0.0/0" (all IPs) is not recommended for security reasons.

Activating a Module​

  • Add a new entry to the modules: [] array
  • module: name of the module
  • position: position on the mirror
  • config: optional settings

Disabling a Module​

  • Set disabled: true in the module object

Global Settings​

  • Language (language), time format (timeFormat), units (units)

Save & Refresh​

  • Save your changes and refresh the mirror

See Configuration Examples for more patterns and best practices.

For advanced configuration options and further details, see the official MagicMirror² documentation.