Add plugins option to enable the MeshCentral plugin system (#7)

Adds a new `plugins` boolean option (default: false). When enabled, the
add-on writes `plugins: { enabled: true }` into the generated
config.json, which unlocks the Plugins tab under My Server so
administrators can install, update and remove MeshCentral plugins.

Installed plugins are stored under /data/meshcentral-data/plugins, so
they persist across add-on restarts, updates and HA backups.

Co-authored-by: ddcash <25888001+ddcash@users.noreply.github.com>
Co-authored-by: Claude Fable 5 <noreply@anthropic.com>

Author: ddcash

CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## \[0.2.13\] - 2026-07-09
+
+### Added
+
+- `plugins` — enable the MeshCentral plugin system. Adds a **Plugins** tab under **My Server** where administrators can install, update and remove plugins. Installed plugins are stored under `/data/meshcentral-data/plugins` and persist across restarts, updates and backups. Disabled by default.
+
 ## \[0.2.12\] - 2026-07-07
 
 ### Added

README.md

@@ -153,6 +153,7 @@ All settings are in the add-on **Configuration** tab. No JSON files to edit. The
 | `allow_high_quality_desktop` | `true` | Allow users to set remote desktop quality above 60%. Set to `false` to cap quality and reduce bandwidth |
 | `self_update` | `false` | Let MeshCentral automatically update itself after midnight |
 | `maintenance_mode` | `false` | When enabled, only administrators can log in |
+| `plugins` | `false` | Enable the plugin system — adds a Plugins tab under My Server for installing and managing plugins |
 
 ### Backup
 

meshcentral/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## \[0.2.13\] - 2026-07-09
+
+### Added
+
+- `plugins` — enable the MeshCentral plugin system. Adds a **Plugins** tab under **My Server** where administrators can install, update and remove plugins. Installed plugins are stored under `/data/meshcentral-data/plugins` and persist across restarts, updates and backups. Disabled by default.
+
 ## \[0.2.12\] - 2026-07-07
 
 ### Added

meshcentral/DOCS.md

@@ -189,6 +189,13 @@ Allow MeshCentral to update itself. Not recommended — the add-on controls the
 
 Block all user logins while keeping agents connected. Useful during configuration changes.
 
+#### `plugins`
+**Default:** `false`
+
+Enable the MeshCentral plugin system. When enabled, a **Plugins** tab appears under **My Server** where administrators can install, update and remove plugins from the [plugin registry](https://github.com/Ylianst/MeshCentral/blob/master/docs/docs/meshcentral/plugins.md) or from a plugin's `config.json` URL.
+
+Installed plugins are stored under `/data/meshcentral-data/plugins`, so they persist across add-on restarts, updates and Home Assistant backups.
+
 #### `auto_remove_inactive_devices`
 **Default:** `0` _(disabled)_
 

meshcentral/config.yaml

@@ -1,6 +1,6 @@
 {
   "name": "MeshCentral",
-  "version": "0.2.12",
+  "version": "0.2.13",
   "slug": "meshcentral",
   "description": "Self-hosted remote device management — monitor and control your PCs from Home Assistant",
   "url": "https://github.com/andlo/ha-meshcentral-addon",
@@ -42,6 +42,7 @@
     "auto_remove_inactive_devices": 0,
     "guest_device_sharing": true,
     "allow_framing": false,
+    "plugins": false,
     "user_allowed_ip": "",
     "user_blocked_ip": "",
     "agent_allowed_ip": "",
@@ -83,6 +84,7 @@
     "auto_remove_inactive_devices": "int",
     "guest_device_sharing": "bool",
     "allow_framing": "bool",
+    "plugins": "bool",
     "user_allowed_ip": "str?",
     "user_blocked_ip": "str?",
     "agent_allowed_ip": "str?",

meshcentral/run.sh

@@ -16,6 +16,7 @@ NO_2FA=$(bashio::config 'no_2fa')
 SITE_STYLE=$(bashio::config 'site_style')
 GUEST_SHARING=$(bashio::config 'guest_device_sharing')
 ALLOW_FRAMING=$(bashio::config 'allow_framing')
+PLUGINS=$(bashio::config 'plugins')
 LOGIN_COUNT=$(bashio::config 'max_invalid_login_count')
 LOGIN_TIME=$(bashio::config 'max_invalid_login_time')
 AUTO_REMOVE=$(bashio::config 'auto_remove_inactive_devices')
@@ -115,6 +116,13 @@ if [ "$NO_2FA" = "true" ]; then
     SETTINGS=$(echo "$SETTINGS" | jq '. + {no2FactorAuth: true}')
 fi
 
+# Plugins — adds the Plugins tab under My Server where plugins are installed and managed.
+# Installed plugins live under the datapath and survive add-on restarts and updates.
+if [ "$PLUGINS" = "true" ]; then
+    SETTINGS=$(echo "$SETTINGS" | jq '. + {plugins: {enabled: true}}')
+    bashio::log.info "Plugins enabled (plugins.enabled: true)"
+fi
+
 # Invalid login rate limiting
 SETTINGS=$(echo "$SETTINGS" | jq \
     --argjson cnt "$LOGIN_COUNT" \

meshcentral/translations/en.yaml

@@ -138,6 +138,14 @@ configuration:
       Disabled by default to prevent clickjacking. Only enable if you need to embed MeshCentral
       in another dashboard.
 
+  plugins:
+    name: Enable plugins
+    description: >-
+      Enable the MeshCentral plugin system. Adds a Plugins tab under My Server where
+      administrators can install, update and remove plugins (e.g. event log, routing).
+      Installed plugins are stored in the add-on data folder and survive restarts and updates.
+      Disabled by default.
+
   user_allowed_ip:
     name: Allowed user IPs
     description: >-