Übersicht

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.

Laufzeit-Argumente

Web-UI: http://[IP]:[PORT:80]/
Netzwerk: bridge
Shell: bash
Privilegiert: false

Konfiguration der Vorlage

Web UI PortPorttcp

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

Ziel: 80
Standard: 8080
Wert: 8080

MQTT PortPorttcp

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

Ziel: 1883
Standard: 1883
Wert: 1883

Data DirectoryPathrw

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

Ziel: /data
Standard: /mnt/user/appdata/garagestack
Wert: /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.

Ziel: SAIC_USER

MG iSmart PasswordVariable

Your MG iSmart account password.

Ziel: SAIC_PASSWORD

MG RegionVariable

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

Ziel: SAIC_REGION
Standard: eu
Wert: 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

Ziel: POSTGRES_PASSWORD

JWT SecretVariable

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

Ziel: 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.

Ziel: CORS_ORIGIN
Standard: http://localhost:8080
Wert: 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