Skip to content

Configuration

Ben edited this page Jul 19, 2026 · 1 revision

⚠️ It is recommended (and easier) to use the Homebridge UI plugin settings screen to configure the plugin. The settings screen is generated from the same source as this page, and always reflects the full, current set of options.

This page is for reference and for users who edit their configuration JSON manually.

Required Settings

Add the following to your configuration file inside the platforms array.

{
   "name": "ControlMySpa",
   "credentials": {
      "email": "your-controlmyspa-email",
      "password": "your-controlmyspa-password"
   },
   "platform": "ControlMySpa"
}
  • ⚠️ The "platform": "ControlMySpa" line must not be changed
  • Use the same credentials as the ControlMySpa mobile app - your spa must already be registered there.

Credentials (credentials)

Setting Type Default Explanation
email string - The email for your ControlMySpa account.
password string - The password for your ControlMySpa account.

Options (options)

Setting Type Default Explanation
devices array -
refreshRate number - How often, in seconds, the plugin fetches the latest spa state from the ControlMySpa cloud. Default is 60, minimum is 30.
logging string - Choose the logging level for the plugin.

Clone this wiki locally