概述

GarageStack is an open-source vehicle monitoring dashboard for MG / SAIC electric and plug-in hybrid vehicles. It connects to the MG iSmart cloud via the SAIC MQTT Gateway and stores all data locally in an embedded PostgreSQL database. Features include a live dashboard, charging and efficiency statistics, trip history with heatmap visualisation, and Web Push notifications. Everything runs in a single container -- no external database or MQTT broker required.

运行时参数

网络用户界面: http://[IP]:[PORT:80]/
网络: bridge
外壳: bash
特权: false

模板配置

Web UI PortPorttcp

Host port for the GarageStack web interface. Open this in your browser.

目标: 80
默认值: 8080
价值: 8080

MQTT PortPorttcp

Host port for the internal Mosquitto MQTT broker. Only expose if you need direct MQTT access from other devices.

目标: 1883
默认值: 1883
价值: 1883

Data DirectoryPathrw

Persistent storage for the PostgreSQL database, MQTT data, application logs, and ASP.NET Data Protection keys. Back this up regularly.

目标: /data
默认值: /mnt/user/appdata/garagestack
价值: /mnt/user/appdata/garagestack

MG iSmart EmailVariable

Your MG iSmart account email address. Must be the vehicle OWNER account -- shared or secondary accounts lack the write permissions needed to register alarm switches and will result in API error 1100003. Use a separate account on the MG phone app to avoid session conflicts.

目标: SAIC_USER

MG iSmart PasswordVariable

Your MG iSmart account password.

目标: SAIC_PASSWORD

MG RegionVariable

Region your vehicle is registered in: eu (Europe), cn (China), or row (Rest of World).

目标: SAIC_REGION
默认值: eu
价值: eu

Database PasswordVariable

Password for the embedded PostgreSQL database. Set a strong random value -- you will not need to enter this again. Generate one with: openssl rand -base64 24

目标: POSTGRES_PASSWORD

JWT SecretVariable

Secret used to sign login tokens. Must be at least 32 characters. Generate with: openssl rand -base64 32

目标: JWT_SECRET

App URLVariable

The exact URL you use to open GarageStack in your browser, e.g. http://192.168.1.100:8080. Must match exactly -- wrong value causes login to fail.

目标: CORS_ORIGIN
默认值: http://localhost:8080
价值: http://localhost:8080

VAPID Public KeyVariable

VAPID public key for Web Push notifications. Leave empty to disable push notifications (the rest of the app works fine without them). Generate a key pair with: npx web-push generate-vapid-keys