RELEASE NOTES

v5.2.5 - TEDAPI diagnostics & upgrade.sh env file check

New Features

• verify.sh --tedapi — new detailed Gateway WiFi/TEDAPI diagnostics mode that reports Gateway WiFi signal strength and TEDAPI connectivity, to help debug SolarOnly-fallback and missing-vitals symptoms. TEDAPI_HOST is parsed as host:port where present, PW_HOST is masked in output so logs are safe to share, and the final verdict is TEDAPI-aware. (PR #857 by @jasonacox-sam)

Bug Fixes

• upgrade.sh detects unquoted env values containing spaces — older or hand-edited installations can carry an unquoted value in grafana.env (e.g. GF_AUTH_ANONYMOUS_ORG_NAME=Main Org.). When compose-dash.sh sources the file, the shell tries to run the word after the space as a command, producing the cryptic grafana.env: line 22: Org.: command not found failure during ./upgrade.sh. upgrade.sh now checks for this just after the Grafana env file is created/verified: it prints a pointed error showing the offending line(s) and the correct quoted form, and offers to add the quotes automatically (original saved as grafana.env.bak); declining exits with instructions to fix it manually. (PR #860, closes #859)

Contributors

Thanks to @dkerr64 for reporting the unquoted grafana.env failure and for the shellcheck suggestion — an optional shellcheck CI check for the project’s shell scripts will follow separately.

v5.2.4 - Upgrade pypowerwall proxy to v0.17.0t100 (SolarOnly recovery fix)

Updates

• pypowerwall proxy 0.17.0t100 — bumps the pinned proxy image from 0.16.2t97. Notable changes since 0.16.2:
  • fix: TEDAPI auto-recovery wedge — after a fully-failed reconnect attempt, the SolarOnly fallback recovery thread could stall permanently, leaving the proxy serving solar-only data until the container was restarted. Recovery now retries reliably (initial 60s interval, capped at 300s). Reported by @dthorndyke (pypowerwall#366, fixed in pypowerwall#367, shipped in pypowerwall v0.16.4). This is the “no longer recovers from SolarOnly mode after upgrading to v5.2.3” symptom reported in #855 — the underlying network drops to the TEDAPI gateway path are unchanged, but the proxy now recovers from them again.
  • feat(tedapi): lifetime energy accumulators merged into /api/meters/aggregates (pypowerwall#372, pypowerwall v0.16.5)
  • feat(proxy): optional bearer-token auth mode for the proxy API (pypowerwall#359 by @Nexarian, pypowerwall v0.17.0)
  • fix(tedapi): TEDAPIApiVersion is now comparable, and a Content-Type typo (octet-string → octet-stream) was corrected (pypowerwall#363, pypowerwall#364 by @Nexarian)

No dashboard re-import is needed — run ./upgrade.sh and the stack is recreated with the new image. PW_TEDAPI_RECOVERY remains on by default (yes).

Contributors

Thanks to @ViktorJp for reporting the SolarOnly recovery failure on v5.2.3 (#855), to @dthorndyke for the precise upstream report of the recovery wedge (pypowerwall#366), and to @Nexarian for the bearer auth mode and TEDAPI fixes carried in this image.

v5.2.3 - Powerwall MCP server & pypowerwall time series data directory

New Features

• tools/powerwall-mcp/ — a new optional, self-contained MCP (Model Context Protocol) server that lets AI agents (Claude, Open WebUI, Hermes, etc.) query the dashboard’s InfluxDB 1.8 data in plain language. It understands that the Telegraf exporter writes the same measurement names into multiple retention policies (autogen, raw, vitals, kwh, daily, grid, pod, alerts), so it can generate correct queries against the right data. Includes a standalone Dockerfile/docker-compose.yml (separate from the main dashboard stack), SELECT-only query validation, optional bearer-token auth, bounded query results, and a mock client with regression tests. Based on ampersandru/powerwall-dashboard-mcp (MIT-licensed, contributed by the original author). (PR #850 by @jasonacox-sam, closes #848)
• pypowerwall time series data directory — laying groundwork for an upcoming pypowerwall-server time series feature (which will eventually replace the current proxy), powerwall.yml now bind-mounts a new .pypowerwall_data/ directory to /data in the pypowerwall container. setup.sh and upgrade.sh create this directory automatically and chown it to PWD_USER (the uid:gid the container actually runs as, per powerwall.yml) so Docker doesn’t auto-create it as root on first container start — which would otherwise cause permission errors, including for installs where the configured PWD_USER differs from the invoking host user. verify.sh now also checks that .pypowerwall_data/ exists and is writable by the pypowerwall container.

Updates

• weather411 v0.2.5 — hardened the OpenWeatherMap fetch loop: the configured TIMEOUT is now actually passed to the HTTP request (previously it was read and reported but never used, so a hung connect/read could stall the fetch thread indefinitely), non-200 responses now log the HTTP status code along with OpenWeatherMap’s error message (e.g. 401 Invalid API key, 429 rate limited), and exception handlers now report the real underlying error (DNS failure, connection refused, TLS, JSON decode, etc.) instead of a generic message — all on stderr, so the detail is visible in docker logs even with DEBUG disabled. Same treatment for the InfluxDB write error path. Inspired by the debugging of #849 (thanks @anderep!).

Contributors

Thanks to @jasonacox-sam (Sam Cox) for contributing the Powerwall MCP server (PR #850), and to @ampersandru for the original powerwall-dashboard-mcp implementation it’s based on.

v5.2.2 - pypowerwall ulimits & weather411 0.2.4

Bug Fixes

• pypowerwall nofile ulimits — the pypowerwall container in powerwall.yml now has explicit nofile soft/hard ulimits set to 65536, matching the existing influxdb and grafana services. This prevents [Errno 24] Too many open files errors in the pypowerwall logs under heavy load. (PR #846 by @johncuthbertuk)

Updates

• weather411 v0.2.4 — bumped the weather411 container image to 0.2.4.

Contributors

Thanks to @johncuthbertuk for reporting and fixing the missing ulimits (pypowerwall#369, PR #846).

v5.2.1 - Restore Script: Companion restore.sh for backup.sh

Upgrading

• Grafana datasource UID change — auto-provisioned InfluxDB and Sun/Moon datasources now have explicit, stable UIDs (pwd-influxdb-auto and pwd-sunandmoon-auto) instead of Grafana-generated ones. This prevents UID collisions and drift across reprovisioning. Existing installs: after upgrading, Grafana will create new datasource entries with the pinned UIDs. If dashboards show “datasource not found” on affected panels, either re-import the dashboard or re-link the panel datasource to the same-named entry in the Grafana UI. (PR #840 by @youzer-name)

New Features

• Restore script — new backups/restore.sh.sample, an automated companion to backup.sh.sample, based on restore_v16a.sh by @JonMurphy (#836). One command restores a backup archive on the same machine or migrates to a new one:
  • Auto-detects the Powerwall-Dashboard directory from the script’s own location
  • Checks staging disk space before extracting (warns and offers TMPDIR override — protects RAM-backed /tmp from multi-GB archives)
  • Non-destructive — moves existing InfluxDB data/meta/wal and grafana.db aside as .pre-restore.<timestamp> copies (rollback path) instead of deleting
  • Restores InfluxDB from the influxd backup -portable snapshot into a clean instance, then re-creates continuous queries from the archive’s continuous_queries.txt (live CQ state, including customizations) with influxdb.sql as fallback — influxd restore -portable does not reliably restore CQs (known InfluxDB 1.x limitation). CQ replay output is checked for errors (the influx CLI exits 0 even on failed statements).
  • Restores Grafana database and provisioning files with correct ownership, deriving PWD_USER as the invoking user’s uid:gid (SUDO_UID:SUDO_GID) — the same convention setup.sh uses — with a guard against running from a root shell
  • Restores user configuration files (*.env, telegraf.local, etc.) while skipping git-managed project files (powerwall.yml, telegraf.conf, influxdb.conf, VERSION) so an older backup can never downgrade the stack or break future git pull/upgrades
  • Restores weather/weather411.conf and .auth/ Tesla cloud tokens (when present in the archive), so cross-machine migrations keep weather and cloud-mode credentials without re-authenticating
  • Finishes with compose-dash.sh up -d so containers are recreated and restored settings (including the rewritten PWD_USER) actually take effect
• Backup script — backup.sh.sample now auto-detects the dashboard directory (no more editing DASHBOARD= by hand), verifies the influxdb container is running and checks dashboard-disk free space before taking the snapshot, exports live continuous queries into the archive as a safety net, captures weather/weather411.conf and .auth/ tokens, checks the exit code of influxd backup (no more silently archiving a failed snapshot), verifies archive integrity after creation, creates archives with mode 600 (they contain credentials), and aborts with a clear message if the staging area can’t hold the snapshot (with TMPDIR override).

Documentation

• backups/README.md — documents the restore script as the recommended method; manual restore steps retained as a fallback and corrected to exclude git-managed files and use compose-dash.sh up -d.

Contributors

Thanks to @JonMurphy for the original restore_v16a.sh script, testing, and the detailed restore-procedure feedback in #836.

Links

• Reported in #836
• Added in PR #838

  v5.2.0 - Backup Overhaul, Outage Export, verify.sh Fixes & More

Backup Script Improvements

• InfluxDB consistent snapshots — the backup script now archives the InfluxDB snapshot (via influxd backup -portable) instead of tarring the live influxdb/ directory while InfluxDB is actively writing. This eliminates the file changed as we read it warnings and eliminates the risk of archive corruption from concurrent writes. The -portable flag produces a version-independent snapshot that can be restored reliably on any InfluxDB 1.x instance.
• Grafana database backup — grafana.db is now backed up using sqlite3 .backup (SQLite’s online backup API) for a consistent copy. Falls back to cp -a if sqlite3 is not installed on the host, with a hint to sudo apt install sqlite3.
• Configuration files backup — all .env, .conf, and .yml/.yaml files at the dashboard root are now included in the archive, making disaster recovery straightforward. A fixed CONFIG_FILES array guarantees essentials (compose.env, pypowerwall.env, telegraf.local, etc.) are always captured; globs catch anything additional.
• Staging directory with trap cleanup — the script uses mktemp -d for staging with a trap to clean up on exit.
• Proper quoting — all variable references are properly quoted throughout the script.

New Features

• Outage export script — tools/export_outages/export_outages.py by @ondrejch exports grid outage data from InfluxDB as CSV. Reads grid_status from powerwall.grid.http, merges consecutive readings into outage intervals, and outputs columns: StartTime, EndTime, DurationMinutes, StatusValue. Supports all, today, yesterday, or custom date ranges. (PR #833)

Bug Fixes

• verify.sh --debug mode and bc fix — adds --debug flag that disables set -e and enables set -x tracing so users can see exactly where the script fails. Makes the bc call non-fatal — if bc is not installed, falls back to the raw battery level with a visible warning instead of silently killing the script. Fixes #827 reported by @hatchjdecho. (PR #834)

Documentation

• Debian Docker installation instructions — adds a Debian section to tools/DOCKER.md with steps tested on Debian Trixie (v13), including the correct Docker GPG key and apt repository paths. Based on testing by @JonMurphy. (#831, PR #832)

Backup Archive Structure

influxdb/     # InfluxDB portable snapshot (metadata + shard data)
grafana/      # grafana.db (consistent copy) + provisions/
config/       # .env, .conf, .yml/.yaml configuration files

Files Changed

• backups/backup.sh.sample — rewritten with three-part backup approach
• backups/README.md — updated backup format description, restore instructions, and automation guide
• tools/export_outages/export_outages.py — new outage export tool
• tools/export_outages/README.md — usage documentation
• tools/DOCKER.md — Debian installation instructions
• verify.sh — --debug mode and non-fatal bc
• VERSION — 5.1.7 → 5.2.0
• upgrade.sh — version consistency

Contributors

Thanks to the community members who made this release possible:

• @JonMurphy — reported the backup corruption issue (#825), tested every iteration of the backup script, suggested the -portable flag, reviewed config backup scope, tested Debian Docker instructions (#831), and confirmed the final build A-OK
• @hulkster — verified weather data backup coverage and asked about historical weather import options
• @ondrejch — contributed the outage export script export_outages.py (PR #833)
• @hatchjdecho — reported the verify.sh silent exit bug (#827) with detailed troubleshooting

Links

• Backup issue: #825
• Backup PR: #826
• Outage export: PR #833
• verify.sh fix: #827 / PR #834
• Debian Docker docs: #831 / PR #832

v5.1.7 - Upgrade pypowerwall Proxy to v0.16.2t97

Upgrade

• Upgrades the pypowerwall proxy container from v0.15.13t94 to v0.16.2t97.

What’s New in the Proxy (v0.15.13t94 → v0.16.2t97)

v0.16.2t97 — TEDAPI Fallback, v1r Diagnostics, and Firmware Version Improvements

• feat(proxy): TEDAPI SolarOnly fallback auto-recovery — when TEDAPI connectivity is lost after a startup network blip, the proxy can continue serving solar data without interruption and recover automatically when PW_TEDAPI_RECOVERY=yes is set in pypowerwall.env. This recovery path is opt-in and disabled by default. Added for #821.
  • Background probe thread retries with exponential backoff (60s → 300s max); hardware-verified on live PW3+follower
  • /health and /stats now include a fallback_mode block with status, reason, and recovery attempt count
  • POST /health/reset resets fallback state and triggers an immediate recovery attempt
• fix(v1r): PENDING_VERIFICATION and UNKNOWN_KEY_ID auth warnings now surface at normal log level — previously required PW_DEBUG=yes
• feat(tedapi): get_firmware_version() unified across V2024_06/V2026_06 query sets and basic/v1r transports
• fix(proxy image): the pypowerwall image’s Dockerfile HEALTHCHECK now uses curl — the prior wget-based check failed silently on Alpine and could mark the proxy (unhealthy) even when it was running normally. Powerwall-Dashboard’s compose-level pypowerwall healthcheck in powerwall.yml remains a separate check.

v0.16.1 — Windows TLS Fix for Tesla Auth

• fix(windows): TLS capped to 1.2 on Windows to fix 403 Forbidden during Tesla PKCE auth flow — the Windows OpenSSL TLS 1.3 fingerprint was being rejected by Tesla during token exchange. Linux/macOS retain TLS 1.3.
• fix(register): api_call() now uses httpx with HTTP/2 for Tesla API endpoints (Tesla now requires HTTP/2 for owner-api.teslamotors.com calls as of June 2026)

v0.16.0 — Code Review Fixes: Correctness, Security, and Robustness

• fix(critical): set_operation()/set_mode() no longer silently lowers battery reserve — scale-aware fix per backend
• fix(critical): Proxy degradation-cache crash fixed — /csv and /json crashed with AttributeError during gateway outages
• fix(critical): alerts(alertsonly=False) crash fixed — TypeError since introduction
• fix(critical): FleetAPI token refresh wedge fixed — stuck refreshing flag could permanently block the client
• fix(security): Proxy DISABLED/ALLOWLIST matching no longer bypassable via query string
• fix(security): Unallowlisted /api/* paths no longer proxied to gateway with proxy’s credentials
• fix(security): GET /control/max_backup CSRF hardening; constant-time token comparison; 4KB POST body cap
• fix(security): /help stored XSS fixed; credential files now created 0600 atomically; tokens redacted from debug logs
• fix(performance): Local negative caching now actually works; native lock timeouts removed
• fix(perf): FleetAPI reuses one HTTP/2 client and never re-sends POSTs after transmission (eliminates duplicate write commands)
• fix: 19 crash-on-None fixes across all backends and the proxy
• 224 regression tests passing (up from 123 pre-v0.16.0); hardware-verified against TEDAPI WiFi, v1r+WiFi hybrid, Cloud, and FleetAPI modes

  v5.1.6 - Upgrade Script Grafana Teardown Guard

Bug Fix

• Guard the Grafana container teardown in upgrade.sh with an existence check (docker ps -aq -f name=^grafana$), matching the pattern already used for pypowerwall, telegraf, weather411, and tesla-history. Previously, if no Grafana container existed, docker stop grafana returned a non-zero status and aborted the upgrade before the stack could be updated or restarted. In migration paths that had already stopped services, this could leave the stack down. This affected users who disable the bundled Grafana via a compose override (profiles: ["disabled"]) to reuse an existing Grafana instance.
  • Reported in #819. Fixed in PR #820.

v5.1.5 - Inverter Power Panel Fix (4-string & 6-string Systems)

Bug Fix

• Fix the Inverter Power panel showing “No data” on systems with fewer than 6 strings per inverter — the majority of residential single-inverter installs. The cq_inverters continuous query computes InverterN = A_Power+B_Power+C_Power+D_Power+E_Power+F_Power; on 4-string systems, E_Power/F_Power don’t exist in raw.http, and InfluxDB binary arithmetic returns null for the entire sum when any operand is missing.
  • Fix: Each InverterN target is replaced with two rawQuery sub-queries — one for base strings (A–D, always present) and one for extended strings (E–F, present only on 6-string systems). Grafana stacking combines them correctly.
  • No continuous query changes needed — historical per-string data is read directly from the strings retention policy as-is.
  • Applied to dashboard.json, dashboard-alt.json, dashboard-min-mean-max.json, and dashboard-no-animation.json.
  • Reported by @abains in #814. Fixed in PR #815.

v5.1.4 - Weather411 Healthcheck Fix

Bug Fix

• Revert the weather411 healthcheck back to wget. PR #809 changed both pypowerwall and weather411 healthchecks from wget to curl, but the weather411 container is built on python:3.8-alpine which ships with wget (busybox) — not curl. This caused Docker to mark weather411 as (unhealthy).
  • The pypowerwall healthcheck correctly stays on curl since that container uses python:3.10-slim (Debian).
  • Reported by @jasonacox after merging #809.

v5.1.3 - Healthcheck Fix (wget → curl)

Bug Fix

• Replace wget healthchecks with curl -sf in powerwall.yml for the pypowerwall service. The pypowerwall container was switched from Alpine to python:3.10-slim (Debian-slim) in v5.1.2 to fix Tesla TLS fingerprint issues — but Debian-slim does not ship with wget, causing Docker to mark the container (unhealthy) even when it was serving data correctly. curl is already present in the Debian-slim image and is already used by the influxdb and grafana healthchecks.
  • The pypowerwall healthcheck now uses the /health endpoint (curl -sf http://pypowerwall:8675/health > /dev/null).
  • Reported in #808. Fixed in PR #809.

v5.1.2 - Proxy Docker Reliability Fixes

pyPowerwall Update

• Update pypowerwall proxy Docker image to 0.15.13t94.
  • Zombie process fix (PID 1): Installs a SIGCHLD handler in proxy/server.py to reap terminated healthcheck child processes, and adds tini to the Dockerfile as defense-in-depth. Without this fix, each 30-second wget healthcheck spawned by Docker’s HEALTHCHECK becomes an unreaped <defunct> zombie that accumulates for the life of the container and can eventually exhaust the PID table. Affects any deployment where the container runs as PID 1 (the default). (pypowerwall PR #343)
  • Alpine → Debian-slim base switch: Switches all four Docker build platforms from python:3.10-alpine (musl libc) to python:3.10-slim (Debian/glibc). Alpine’s musl libc produces a TLS ClientHello fingerprint that Tesla rejects for token refresh requests after the initial access token expires (~8 hours), causing 403 token expired errors in long-running Docker deployments. This is the same root cause already fixed in tesla-history (v5.0.11). (pypowerwall PR #345)

v5.1.1 - Bug Fix Release

Bug Fix

• Fix grafana.env shell error when anonymous access is enabled: GF_AUTH_ANONYMOUS_ORG_NAME="Main Org." was written without quotes, causing bash to interpret Org. as a separate command when compose-dash.sh sources the file. The value is now quoted in both anonymous-access.sh and grafana.env.sample.
  • Reported by @JonMurphy after upgrading to v5.1.0; fix identified by @mccahan.

Documentation

• Clarify v1r mode password prompt — the password comes from the QR sticker on the Powerwall 3 unit, not the Gateway. Updated both setup.sh and README.md to eliminate ambiguity for PW3 owners who also have a separate Gateway device.
  • Reported by @michalperth in Discussion #784.

v5.1.0 - Anonymous Dashboard Access

New Feature

• Add anonymous access mode for Grafana dashboard — allows running the dashboard without a login prompt on trusted/private networks.
  • New anonymous-access.sh script invoked during setup.sh to configure access mode.
  • Three options: Username/Password (default), Anonymous Read-Only, Anonymous Read/Write.
  • Re-runnable: users can change access mode at any time by re-running setup.sh.
  • Cleans up previous configuration before applying new settings.
  • Contributed by @mccahan (PR #583).

v5.0.11 - tesla-history Docker Fix (Alpine → Debian)

tesla-history Update

• Update tesla-history to v0.1.9.
  • Switch Dockerfile from python:3.11-alpine to python:3.11-slim (Debian-based). Alpine’s musl libc produces a TLS ClientHello fingerprint that Tesla rejects, causing 403 errors after token refresh. Debian-based images use OpenSSL, which produces the accepted fingerprint.
  • Add httpx and h2 to the Docker image dependencies to enable HTTP/2 for all Tesla API calls.
  • Require pypowerwall>=0.15.12 in the Dockerfile and README install instructions to ensure the HTTP/2 auth fix and improved token handling are always included.

Documentation

• Updated tools/tesla-history/README.md pip install instructions to require pypowerwall>=0.15.12, httpx, and h2.

v5.0.10 - Cloud Mode Fix (Token + HTTP/2)

pyPowerwall Update

• Update pypowerwall Docker image to 0.15.12t93 (proxy t93).
  • Fixes Tesla Owner API Cloud mode authentication by adding HTTP/2 support for all Tesla auth and API endpoints.
  • Resolves the 401/403 errors that affected Cloud mode (Option 2) users since Tesla’s June 2026 protocol change requiring HTTP/2.
  • Adds improved token handling for SSH/headless setups — both Access Token and Refresh Token are now required during setup.
  • See pypowerwall PR #333 for details on the token input fix.

tesla-history Update

• Update tesla-history to v0.1.8 — includes compatibility fixes for the new auth flow.

Documentation

• Updated README.md Cloud mode section to document the new token-based auth process (Access Token + Refresh Token required).
• Added note about the HTTP/2 requirement and minimum version (v5.0.10).
• Added reference to the tesla_auth desktop app as an alternative token generation method for headless users.

v5.0.9 - Tesla Owner API HTTP/2 Fix

pyPowerwall Update

• Update pypowerwall Docker image to 0.15.11t93 (proxy t93).
  • Adds HTTP/2 support for Tesla Owner API authentication endpoints (auth.tesla.com and owner-api.teslamotors.com), resolving the 401/403 errors that affected Cloud mode (Option 2) users since Tesla’s June 2026 protocol change.
  • See pypowerwall PR #326 for details.

Documentation

• Removed the temporary Tesla Owner API Auth Change notices from README.md — the fix is now included in the default Docker image.

v5.0.8 - v1r Setup Fix and pyPowerwall Update

pyPowerwall Update

• Update pypowerwall to v0.15.10 (proxy t90).
  • v0.15.8+ correctly supports -authpath flag for v1r RSA key registration, allowing the key to be written to a custom directory instead of the default /app/ location.
  • This eliminates the permission error (PermissionError: [Errno 13] Permission denied: '/app/tedapi_rsa_private.pem') that occurred when the container runs as a non-root user.

Setup Fixes

• Fixed v1r RSA key registration path: setup.sh now passes -authpath /app/.auth to pypowerwall setup -v1r, which writes the RSA key directly to the bind-mounted .auth/ directory. No manual key copying or root workarounds needed.
• Fixed RSA key path mismatch: PW_RSA_KEY_PATH was set to .auth/pypowerwall_rsa_key.pem but v1r registration generates tedapi_rsa_private.pem. Corrected to .auth/tedapi_rsa_private.pem.
• Added post-registration verification: After v1r registration, setup.sh verifies the RSA key file exists in .auth/ and warns if registration may have failed.
• Added permission normalization: chmod -R a+r .auth/ runs after registration to ensure the runtime user can read the key file.
• Added mode assertion for existing installations: When re-running setup.sh and keeping existing credentials, the script now validates that pypowerwall.env has the correct settings for the selected mode (v1r requires PW_HOST, PW_GW_PWD, and PW_RSA_KEY_PATH). Missing settings are prompted for and added.

Important Reminder

Always use the project scripts to manage the stack:

./compose-dash.sh down
./compose-dash.sh up -d

Plain docker compose does NOT source the environment files (compose.env, grafana.env, pypowerwall.env), which can cause settings to be silently ignored on restart.

v5.0.7 - Custom Grafana Port Support

Dashboard Updates

• Fixed support for custom Grafana ports — users who changed GF_SERVER_HTTP_PORT in grafana.env from the default 9000 can now use compose-dash.sh and verify.sh without errors by @nadams5755 in https://github.com/jasonacox/Powerwall-Dashboard/pull/773
  • compose-dash.sh now loads grafana.env alongside compose.env so Docker Compose sees the custom port.
  • powerwall.yml Grafana healthcheck uses ${GF_SERVER_HTTP_PORT:-9000} instead of hardcoded 9000.
  • verify.sh sources grafana.env and reads GF_SERVER_HTTP_PORT for the service check.
  • Minor linting: cleaned up whitespace in verify.sh and added || true to the terminal-settings RETURN trap to prevent set -e failures.

v5.0.6 - Powerwall 3 Wired LAN Support (v1r)

pyPowerwall Update

• Update pypowerwall to v0.15.6 - includes significant new features and fixes from v0.14.10 through v0.15.6.
  • Powerwall 3 Wired LAN (v1r) Support (v0.15.0): New TEDAPI transport for PW3 access over ethernet using RSA-4096 key authentication — no WiFi connection to 192.168.91.1 required. Includes new pypowerwall setup -v1r CLI command to generate and register an RSA key pair. Optional WiFi fallback (PW_WIFI_HOST) enables hybrid mode and Powerwall 3 follower data.
  • Island Mode Control (v0.15.3): New go_off_grid() and reconnect_grid() functions for Powerwall island mode control.
  • Native Python Tesla Authentication (v0.15.5): Replaces the external tesla-auth binary with a native Python WebView-based login flow. For SSH/headless setups, run python3 -m pypowerwall authtoken on a local machine to obtain a token and paste it during setup.
  • Host:port Support (v0.14.10): Non-standard HTTPS port support (e.g. 192.168.1.50:8443) for travel router and NAT proxy setups mapping multiple gateways to distinct ip:port endpoints.
  • Reserve Scaling & CLI Fixes (v0.15.6): Fixed reserve percent scaling round-trip errors in TEDAPI v1r mode and FleetAPI SOC reporting. CLI redesigned with explicit connection mode flags.

Setup Updates

• setup.sh updated to support new pypowerwall features:
  • Added mode 5 - Wired LAN (v1r): new interactive setup flow for Powerwall 3 ethernet access — prompts for wired LAN IP, full 10-character QR code gateway password, and optional WiFi fallback host (PW_WIFI_HOST) for hybrid mode and follower data. Automatically probes 192.168.91.1 and offers it as the WiFi fallback if reachable.
  • After docker startup, runs pypowerwall setup -v1r inside the container to generate the RSA-4096 key pair and register it with the Powerwall via the Tesla Owner API.
  • Tesla Cloud mode now displays a notice for SSH/remote users explaining how to obtain an auth token from a local machine: pip install pypowerwall -U && python3 -m pypowerwall authtoken.
  • Updated FleetAPI setup to use pypowerwall setup -fleetapi (replacing the deprecated pypowerwall fleetapi command).

v5.0.5 - Tesla-History Auth Fix

• Revise tesla-history script auth method to use refresh token and external Tesla Auth tool for cloud login by @mcbirse in https://github.com/jasonacox/Powerwall-Dashboard/pull/764 - addresses https://github.com/jasonacox/Powerwall-Dashboard/discussions/762
• Minor dashboard fix with alerts panel to prevent alerts extending beyond current time when viewing with time ranges like Today, This week, etc. by @mcbirse in https://github.com/jasonacox/Powerwall-Dashboard/pull/764

v5.0.4 - Alerts Dashboard Fix

Dashboard Updates

• Fixed Alerts State Timeline panel in Grafana 12, which was displaying empty rows for alert types that had no occurrences during the selected time period.
  • Problem: The state-timeline panel was rendering a row for every alert field returned by InfluxDB, even when the field contained only 0 or null values throughout the selected time range. This resulted in a large number of empty, uninformative rows cluttering the panel.
  • Fix: Added a byValue field override using Grafana’s built-in “Fields with values” matcher, which hides any series where the maximum value does not equal 1. A secondary byType: time override ensures the Time field is never inadvertently hidden by the first rule. Only alert rows that actually triggered (have at least one value of 1) during the selected time range are displayed.
  • Resolved “Data outside time range” UI errors while keeping the Alerts query in table format (SELECT *::field) by relying on override-based filtering and updated transformations instead of changing the query to time series format.
  • Updated field rename transformation regex from max_(.*) → $1 to (alerts\.)?max_(.*) → $2 to strip the alerts.max_ measurement prefix from row labels.

v5.0.3 - Grid Outage Fix

pyPowerwall Update

• Update pypowerwall to v0.14.9 - TEDAPI voltage calculation fix for grid outage scenarios - addresses https://github.com/jasonacox/Powerwall-Dashboard/issues/683
  • Fix compute_LL_voltage() function to handle None voltage values when grid is down
  • Added None value handling in three-phase voltage calculations to prevent TypeError exceptions
  • Prevents crashes in /api/meters/aggregates endpoint when grid is offline and voltage readings are unavailable
  • Converts None voltage parameters to 0 before performing arithmetic operations
  • Resolves issue where power flow stats were not displayed during real grid outages (Note: “Go off grid” via app did not trigger this issue)
  • Added comprehensive unit tests to verify None handling behavior for all voltage scenarios

v5.0.2 - Dashboard Enhancements

Dashboard Updates

• Add dynamic color and text to Current State panel by @caubert in https://github.com/jasonacox/Powerwall-Dashboard/pull/734
  • Current State panel now displays descriptive text indicating the flow of power (e.g., “Grid Import”, “Grid Export”, “Charging Battery”, etc.).
  • Panel background color dynamically changes based on power flow state for improved visual feedback.

Bug Fixes

• Fix false alarm in upgrade.sh that incorrectly reported “Grafana environmental settings are outdated” after upgrading to v5.0.0+.

v5.0.1 - Firmware 25.42.2+ Support

pyPowerwall Update

• Update pypowerwall to v0.14.6 - Firmware 25.42.2+ support for gzip-compressed TEDAPI responses.
  • Add gzip decompression support for firmware 25.42.2+ TEDAPI responses - Fix by @bolagnaise in https://github.com/jasonacox/pypowerwall/pull/251
  • Gateway firmware 25.42.2 and later returns gzip-compressed responses for DIN and other TEDAPI endpoints
  • Added decompress_response() helper function to handle both compressed and uncompressed responses transparently
  • Updated all TEDAPI methods (get_din(), get_config(), get_status(), get_device_controller(), get_firmware_version(), get_components(), get_battery_block()) to decompress responses
  • Added error handling for UnicodeDecodeError in DIN decode operation to gracefully handle corrupted or invalid responses
  • Maintains backward compatibility with older firmware versions that return uncompressed responses

v5.0.0 - Grafana Upgrade

Major Updates

• Grafana Upgrade to v12.3: Major version upgrade from Grafana 9.1.2 to 12.3-ubuntu, bringing significant improvements in performance, security, and features.
  • Enhanced data source proxy with improved connection handling
  • Better query performance and visualization capabilities
  • Updated dashboard compatibility and new visualization options
  • Improved security with latest upstream patches

Breaking Changes

• Dashboards: Some older dashboard panels may need updates for compatibility with Grafana 12. A new dashboard.json has been added that updates panels: Savings, Self-Powered, and Current State.

Note: This is a major version upgrade.

v4.9.0 - Performance Improvements

Proxy t86 (20 Dec 2025)

This version introduces the pypowerwall proxy t86 based on pypowerwall v0.14.5. Optimizations are added for TEDAPI and should help with stability and performance for Powerwall 3 owners.

• Performance Caching System:
  • Added comprehensive performance caching layer for high-impact API routes
  • Implemented cached_route_handler() pattern for consistent cache management across endpoints
  • Added performance caching to: /aggregates, /api/meters/aggregates, /vitals, /strings, /temps/pw, /alerts/pw, /freq, /pod, /json, /csv, /csv/v2 endpoints
  • Shared cache optimization: /aggregates and /api/meters/aggregates use same cache key for identical payloads
  • Optimized /csv and /json endpoints from 9 API calls to 6 calls (33% reduction) using aggregates consolidation
  • Eliminated 400-600ms overhead from redundant get_components() fallback calls
  • Typical performance improvements: 99.6% faster cached responses (764ms → 2.9ms for /aggregates)
  • Cache memory monitoring added to /stats endpoint with detailed memory usage breakdown
  • Average overall response time improvement: 58% reduction (165.7ms → 70.2ms)

Performance Metrics Comparison:

API Route	Before (ms)	After (ms)	Improvement	Usage Count	Impact Reduction
/api/meters/aggregates	821.5	151.3	81.6% ⚡	7,992	5,355 seconds saved
/aggregates	764.8	150.7	80.3% ⚡	3,880	2,383 seconds saved
/strings	545.7	37.3	93.2% ⚡	3,945	2,006 seconds saved
/vitals	339.3	33.9	90.0% ⚡	3,946	1,205 seconds saved
/alerts/pw	382.9	87.8	77.1% 🚀	3,881	1,145 seconds saved
/temps/pw	266.0	253.6	4.7% ✅	3,880	48 seconds saved

Total Impact Reduction: ~12,142 seconds (3.4 hours) of response time saved per 8-hour period

• Performance Testing Tool:
  • Added perf_test.py script for comprehensive API performance testing and analysis
  • Tests 27 production API routes with impact scoring (response_time × usage_frequency)
  • Provides min/max/average response times with color-coded performance indicators
• Bug Fixes:
  • Fixed undefined variable cache_ttl_seconds error in graceful degradation system
  • Fixed TypeError in /csv/v2 endpoint: removed invalid force=False parameter from level(), grid_status(), and get_reserve() calls
  • Fixed variable shadowing bug in grid_status() method where type parameter shadowed Python’s built-in type() function
  • Renamed type parameter to output_type throughout codebase for consistency and correctness
• Code Quality & Maintainability:
  • Centralized cache logic in reusable helper functions for improved consistency
  • Improved error handling and logging in safe_pw_call() wrapper
  • Added unit tests for CSV endpoints (TestCSVEndpoints class with 7 test cases)
  • Enhanced error tracking with network error summaries and endpoint statistics
  • Enhanced documentation with comprehensive performance testing guide

v4.8.8 - Tesla-History Fix

• Revise tesla-history script backup event history retrieval due to Tesla API changes by @mcbirse in https://github.com/jasonacox/Powerwall-Dashboard/pull/717 - addresses https://github.com/jasonacox/Powerwall-Dashboard/issues/714
• Update tesla-history to use embedded TeslaPy component of pypowerwall (now required) - install by running pip install pypowerwall
• Revise location detection in setup and weather script for improved error handling

v4.8.7 - PW3 Expansion Pack Fix

• Update pypowerwall to v0.14.4 - See updates: https://github.com/jasonacox/pypowerwall/releases/tag/v0.14.4 with Powerwall 3 expansion pack energy data fixes and battery degradation metrics.
• Fix expansion pack energy data by processing all BMS components in TEDAPI responses - improves data accuracy for systems with PW3 expansion packs by @rlerdorf in https://github.com/jasonacox/pypowerwall/pull/239
• Add Powerwall battery degradation (capacity loss) tracking and visualization to dashboard.
• Enhanced timezone validation in setup.sh with improved POSIX TZ string detection to reject invalid inputs like single digits.
• Add timezone browsing feature with filtering support for easier timezone selection during setup.

v4.8.6 - InfluxDB File Limits and Configuration Updates

• Add ulimits configuration to InfluxDB service to resolve “too many open files” errors by setting soft and hard limits to 65536 by @cwagz in https://github.com/jasonacox/Powerwall-Dashboard/issues/705
• Add enhanced timezone validation with interactive browse feature (? at prompt) supporting filters and multi-level IANA zones (e.g., America/Argentina/Buenos_Aires) and POSIX TZ strings (e.g., GMT+5).
• Add timezone-test.sh standalone test script for timezone validation with interactive and non-interactive modes.
• Minor configuration file changes by @BuongiornoTexas in https://github.com/jasonacox/Powerwall-Dashboard/pull/706
• Quote GF_INSTALL_PLUGINS value in grafana.env.sample by @rlerdorf in https://github.com/jasonacox/Powerwall-Dashboard/pull/703

v4.8.5 - Setup and Verify

• Add enhanced log display options to verify.sh: supports --logs and --no-logs flags to control log output, and interactive prompt for log viewing. Log output is now cleaner and only shown when requested.
• Add input validation for timezone entry in setup.sh to prevent invalid/corrupt values in configuration files. Timezone is now checked against system zoneinfo and format before acceptance.
• Update pypowerwall to v0.14.1 - See updates: https://github.com/jasonacox/pypowerwall/releases/tag/v0.14.1 for error handling updates.

v4.8.4 - pyPowerwall update

• Update pypowerwall to v0.14.0 - See updates: https://github.com/jasonacox/pypowerwall/releases/tag/v0.14.0 with Cloud updates to accommodate Tesla API changes (embedded TeslaPy patch) and fix a bug in FleetAPI for multi-site installations.

v4.8.3 - Docker Compose Updates

• Update pypowerwall to v0.13.2 - See updates: https://github.com/jasonacox/pypowerwall/releases/tag/v0.13.2 with improved connection health monitoring and graceful degradation. Including:

v0.13.2 - TEDAPI Lock Optimization

• Fix TEDAPI lock contention issues causing “Timeout for locked object” errors under concurrent load by optimizing cache-before-lock pattern in core functions
• Optimize get_config(), get_status(), get_device_controller(), get_firmware_version(), get_components(), and get_battery_block() to check cache before acquiring expensive locks
• Remove redundant API call in pypowerwall_tedapi.py get_api_system_status() method
• Fix proxy server KeyError when status response missing version or git_hash keys by using defensive key access
• Fix proxy server KeyError when auth dictionary missing AuthCookie or UserRecord keys in cookie mode
• Improve performance and reduce lock timeout errors in multi-threaded environments like the pypowerwall proxy server
• Enhance compute_LL_voltage() function with voltage threshold detection (100V) to better handle single-phase systems with residual voltages on inactive legs, as well as split- and three-phase systems.
• These optimizations benefit all methods that depend on the core TEDAPI functions, including vitals(), get_blocks(), and get_battery_blocks()

Proxy t77 (11 Jul 2025)

• TEDAPI Lock Optimization and Error Handling: Enhanced proxy stability and performance with comprehensive fixes for TEDAPI-related issues.
  • Fixed KeyError exceptions in proxy server when status response missing version or git_hash keys by implementing defensive key access with .get() method
  • Fixed KeyError exceptions when auth dictionary missing AuthCookie or UserRecord keys in cookie mode, now uses safe fallbacks
  • TEDAPI Performance Improvements: Optimized core TEDAPI functions (get_config, get_status, get_device_controller, get_firmware_version, get_components, get_battery_block) with cache-before-lock pattern to reduce lock contention
  • Removed redundant API calls in TEDAPI wrapper functions to improve response times
  • Enhanced multi-threading support for concurrent proxy requests with reduced lock timeout errors
  • Improved error resilience for different connection modes (local vs TEDAPI) that return varying data structures
• Enhanced Health Monitoring: Added comprehensive endpoint statistics tracking for better observability and debugging.
  • Endpoint Call Statistics: Added tracking of successful and failed API calls per endpoint with success rate calculations
  • Enhanced /health endpoint: Now includes detailed statistics showing:
    • Total calls, successful calls, and failed calls per endpoint
    • Success rate percentage for each endpoint
    • Time since last success and last failure for each endpoint
    • Overall proxy response counters (total_gets, total_posts, total_errors, total_timeouts)
  • Improved /health/reset endpoint: Now also clears endpoint statistics along with health counters and cache
  • Automatic tracking: All endpoints using safe_endpoint_call() automatically tracked (includes /aggregates, /soe, /vitals, /strings, etc.)

Proxy t78 (14 Jul 2025)

• Power flow animation update: Show an image of a Powerwall 3 instead of a Powerwall 2 if it is a PW3 by @JEMcats in https://github.com/jasonacox/pypowerwall/pull/193

v4.8.2 - pypowerwall Updates

• Update pypowerwall version for connection health monitoring and graceful degradation.
• Minor improvements to Docker Compose healthcheck configurations.
• Documentation updates for route management and TEDAPI access changes.

v4.8.1 - Hotfix for Setup

• Fix breaking error with setup.sh script that caused it to fail during geo-location lookup. Improve location parsing to handle JSON errors gracefully.
• Added a prominent notice to the top of the README warning users that, as of Powerwall Firmware 25.10.0+, network routing to the TEDAPI endpoint (192.168.91.1) is no longer supported. Users are instructed to connect directly to the Powerwall’s WiFi and can remove old routes using ./add_route.sh -disable.
• Improved add_route.sh:
  • The -disable option now reliably removes the static route on Linux systems, even if the Powerwall IP is not set, preventing command errors.
  • The script checks for -disable before any prompts or warnings, for a smoother user experience.
  • Documentation and user prompts updated for clarity.

v4.8.0 - Healthchecks & Watchdog

• Enhanced Docker Compose healthchecks for all services (influxdb, pypowerwall, telegraf, grafana, weather411), addresses https://github.com/jasonacox/Powerwall-Dashboard/issues/642
• Added optional watchdog.sh script to monitor pypowerwall container and restarts if unhealthy.
  • -enable option adds watchdog to crontab (every 5 min)
  • -disable option removes watchdog from crontab
  • -debug for verbose output; -h/--help for usage.
• Refactor and feature additions to InfluxDB Viewer (viewer.py):
  • Interactive shell-like interface with colorized and tabular output.
  • Tab completion for commands and queries.
  • --nocolor option for plain output.
  • Added help and error handling.

v4.7.2 - TEDAPI Updates

• Added InfluxDB interactive tool for troubleshooting - https://github.com/jasonacox/Powerwall-Dashboard/tree/main/tools/influxdb-viewer
• Updated dashboard.json to add total Powerwall capacity graph in addition to separate PW stats. This is helpful for systems with PW3 + DC Expansion packs. See https://github.com/jasonacox/Powerwall-Dashboard/issues/632
• Update pypowerwall to v0.13.1 (t75)
• See updates: https://github.com/jasonacox/pypowerwall/releases/tag/v0.13.0
  • Use Neurio for TEDAPI data when Tesla Remote Meter is not present by @Nexarian
  • Add connection pool to TEDAPI by @Nexarian
  • Add METER_Z (Backup Switch) data to vitals and aggregates data
  • Fix logic for aggregates API for consolidated voltage and current data by @jasonacox
• See updates: https://github.com/jasonacox/pypowerwall/releases/tag/v0.13.1
  • Fix missing battery_blocks data on PW3 with Multiple Powerwalls in Local Mode in #131
  • Fix errant API base URL check. by @Nexarian in #185
  • Update TEDAPI to pull battery blocks from vitals for PW3 Systems by @jasonacox in #184

v4.7.1 - Multiple PW3 Strings

• Update pypowerwall to v0.12.12 - See updates: https://github.com/jasonacox/pypowerwall/releases/tag/v0.12.12
  • Bug Fix - Logic added in https://github.com/jasonacox/pypowerwall/pull/169 does not iterate through all PW3 strings. This adds logic to handle multiple PW3 string sets. Reported in https://github.com/jasonacox/pypowerwall/issues/172 by @heynorm
  • Proxy t73 (10 May 2025) - Add /json route to return basic metrics:

{
  "grid": -3,
  "home": 917.5,
  "solar": 5930,
  "battery": -5030,
  "soe": 61.391932759907306,
  "grid_status": 1,
  "reserve": 20,
  "time_remaining_hours": 17.03651226158038
}

v4.7.0 - Firmware 25.10.x

• Starting with Powerwall Firmware 24.10.0 and later, Powerwalls no longer allows routed access to the TEDAPI interface (needed for Powerwall 3 and extended metrics data)
• Updated documentation and setup script to instruct users that direct WiFi access is required for TEDAPI access.

v4.6.7 - Dashboard Fixes

• Fixed mismatched Powerwall references in pwtemps queries of “Powerwall Temps and Fans” and removed a duplicate query by @mcbirse in https://github.com/jasonacox/Powerwall-Dashboard/pull/618
• Fixed issue where Powerwall Dashboard version shows “No data” if time filter set to >3d ago by @mcbirse in https://github.com/jasonacox/Powerwall-Dashboard/pull/618
• Revised dashboard JSON definitions to remove irrelevant queries when rawQuery is false by @mcbirse in https://github.com/jasonacox/Powerwall-Dashboard/pull/618
• README: Fix path for restore tar by @jasonacox in https://github.com/jasonacox/Powerwall-Dashboard/commit/3c55ed5834ee4302752b0f50a1542e1644027557
• Update pypowerwall to v0.12.11 - See updates: https://github.com/jasonacox/pypowerwall/releases/tag/v0.12.11

v4.6.6 - Fan Speeds

• Update pypowerwall to v0.12.9, adds vitals metrics for fan speed, fixes bug with FullPackEnergy calcs, improve thread locking for TEDAPI and adds CSV headers. See release notes: https://github.com/jasonacox/pypowerwall/releases
• Update dashboard to show fan speeds on temperature graph.

v4.6.5 - Coordinates

• Update setup.sh to check for existing LAT and LONG coordinate setting in SunAndMoon auto-provision datasource as reported in https://github.com/jasonacox/Powerwall-Dashboard/issues/589#issuecomment-2704639794.
• Provide disclaimer that ‘already exist’ errors are harmless as reported in https://github.com/jasonacox/Powerwall-Dashboard/issues/597

v4.6.4 - InfluxDB Auto

• Fix URI too long issue by adding POST method for InfluxDB Auto-provision datasource in Grafana reported in https://github.com/jasonacox/Powerwall-Dashboard/issues/591 by @devachnid.
• Update InfluxDB auto-provisioning to allow user editing.

v4.6.3 - SunAndMoon Edit

• Update SunAndMoon datasource auto-provisioning to allow user to edit location.
• Add location LAT and LONG confirmation as part of setup.sh script.

v4.6.2 - Normalize Alerts

Updates to pyPowerwall v0.12.7 which includes:

• Improvements to grid status connected by @Nexarian in https://github.com/jasonacox/pypowerwall/pull/139
• Fix an issue in TEDAPI where the grid status is not accurately reported in certain edge cases. Now, only the “SystemConnectedToGrid” alert will appear if it is present in alerts API. This update also eliminates the risk of duplicate and redundant (e.g. “SystemGridConnected”) alerts.
• Updated aggregates call to include site current (METER_X) and external PV inverter data in solar (METER_Y) by @jasonacox in https://github.com/jasonacox/pypowerwall/pull/142. Reported in Issue #140 by @felberch.
• Alerts in extract_grid_status can be None. This fix addresses this edge case. Fix by @Nexarian in https://github.com/jasonacox/pypowerwall/pull/145 Dashboard updates:
• 580 Use F_Voltage field for string voltage by @davemckelvie in https://github.com/jasonacox/Powerwall-Dashboard/pull/581

v4.6.1 - pyPowerwall Updates

Updates to using pypowerwall v0.12.4 t68 which includes:

• v0.12.4: Address bug iin TEDAPI logic on some systems where Neurio CTS data was not getting processed. Discovery by @anderep in https://github.com/jasonacox/Powerwall-Dashboard/discussions/578#discussioncomment-12033087 - Issue https://github.com/jasonacox/pypowerwall/issues/136 and PR https://github.com/jasonacox/pypowerwall/pull/137. Also adds /csv/v2 API support by @jasonacox in https://github.com/jasonacox/pypowerwall/pull/134
• v0.12.3: Proxy vFix TEDAPI URL from constant GW_IP to constructor selectable host gw_ip by @Nexarian in https://github.com/jasonacox/pypowerwall/pull/129 - The hard-coded 192.168.91.1 for the TEDAPI internal endpoint doesn’t work if you’re using NAT. This change enables support for this use-case. See https://gist.github.com/jasonacox/91479957d0605248d7eadb919585616c?permalink_comment_id=5373785#gistcomment-5373785 for NAP implementation example.
• v0.12.2: Fix bug in cache expiration timeout code that was not honoring pwcacheexpire setting. Raised by @erikgieseler in https://github.com/jasonacox/pypowerwall/issues/122 - PW_CACHE_EXPIRE=0 not possible? (Proxy) - Fix by @jasonacox in https://github.com/jasonacox/pypowerwall/pull/123. Adds WARNING log in proxy for settings below 5s. Changes TEDAPI config default timeout from 300s to 5s and links to pwcacheexpire setting.
• v0.12.1: Large-scale refactor of Powerwall scan function by @Nexarian in https://github.com/jasonacox/pypowerwall/pull/117

v4.6.0 - Powerwall Temps

• Updates to pypowerwall proxy v0.12.0 t66 (https://github.com/jasonacox/pypowerwall/pull/114) which supports a new TEDAPI call to gather vitals that includes Powerwall Temps.
• Updates telegraf.conf to read Dashboard VERSION using ver.sh.
• Updates dashboard.json to include Powerwall Temps and current Dashboard Version.
• Add support for pypowerwall environmental variable PW_NEG_SOLAR to allow users to zero out negative values (see pypowerwall.env.xample)

v4.5.5 - Hotfix

• Fix bug introduced in jasonacox/Powerwall-Dashboard/issues/535 as reported in https://github.com/jasonacox/Powerwall-Dashboard/issues/537 by @wagisdev

v4.5.4 - Misc Bug Fixes

• Fix two spelling mistakes in upgrade script by @wreiske in https://github.com/jasonacox/Powerwall-Dashboard/pull/521
• Fix PW3 Strings E+F metrics by @jplewis2 in https://github.com/jasonacox/Powerwall-Dashboard/pull/528
• k3s/kubernettes install by @cfoos in https://github.com/jasonacox/Powerwall-Dashboard/pull/525
• Fix bug in setup.sh for MacOS hosts #534 by @jasonacox in https://github.com/jasonacox/Powerwall-Dashboard/pull/535

v4.5.3 - TEDAPI Route Tool

• New add_route.sh tool to add persistent TEDAPI network routing by @SCHibbard in https://github.com/jasonacox/Powerwall-Dashboard/pull/520
• User can run add_route.sh to create a persistent route to the Powerwall TEDAPI endpoint. This can be run before setup.sh to allow extended data local mode for PW3 and PW2/+ systems. Existing user can also run this to set the route and re-run setup.sh to select the extended local mode.

v4.5.2 - PW3 and FleetAPI Fixes

• Updates pyPowerwall to v0.11.1 to fix a PW3 bug in TEDAPI and a site ID bug in FleetAPI.
• Fix bug in verify.sh reporting TEDAPI vitals capabilities incorrectly as identified by @SCHibbard in https://github.com/jasonacox/Powerwall-Dashboard/issues/515.
• Update gitattributes to force .env files to have LF line ending by @longzheng in https://github.com/jasonacox/Powerwall-Dashboard/pull/511.

v4.5.1 - Powerwall 3 Metrics

• Updates pyPowerwall to v0.11.0 to include PW3 Vitals: string data, capacity, voltages, frequencies, and alerts.
• Updates InfluxDB CQs to include Strings E-F and expands support for up to 6 Inverters (sets of Strings)

v4.5.0 - Auto Provision Datasources

• Setup: Automatically set up the InfluxDB and Sun-and-Moon data sources in Grafana by @longzheng in https://github.com/jasonacox/Powerwall-Dashboard/pull/512
• This adds an “(auto provisioned)” suffix to the data source name to prevent breaking exiting installations and to allow custom configurations.
• Setup now attempts to automatically detect latitude and longitude for Sun-and-Moon and Weather setup.

v4.4.6 - Current and Voltage

• Add data points for system current and voltages (solar, home, grid and powerwall). Includes continuous queries and dashboard.json update. Currently only viable for local mode, non-PW3, systems.
• Upgrade pypowerwall proxy to v0.10.9 to include TEDAPI mode patch that adds computed voltage and current to aggregates (https://github.com/jasonacox/pypowerwall/pull/107).

v4.4.5 - PW3 Updates

• Powerwall 3 Setup Help - If local setup is selected, it will work with the Powerwall 3 but will produce errors in pypowerwall and not have the complete data. This updates setup.sh so ensure Powerwall 3 setups use full TEDAPI mode for local access. Raised by @pavandave in https://github.com/jasonacox/Powerwall-Dashboard/issues/492.
• Add check in setup.sh script to ensure user has permission to write to the current directory. Raised in https://github.com/jasonacox/Powerwall-Dashboard/discussions/494.
• Update to latest pypowerwall, updates TEDAPI to provide correct Powerwall firmware version. Discovered by @geptto in https://github.com/jasonacox/pypowerwall/issues/97. This function has been integrated into pypowerwall existing APIs and proxy features.

v4.4.4 - Bug Fixes

• Fix setup.sh gateway detection logic to better work on Synology and other host without user ping commands as raised by @zcpnate in #488
• Update to pypowerwall 0.10.6: pyLint code optimization, fix timeout logic for TEDAPI and FleetAPI modes, fix battery backup reserve level scaling for TEDPAI mode, fix grid status bug in FleetAPI mode and fix control mode error in proxy.

v4.4.3 - Minor Fixes

• Update to pypowerwall 0.10.5:

  • Fix for TEDAPI “full” (e.g. Powerwall 3) mode, including grid_status bug resulting in false reports of grid status, level() bug where data gap resulted in 0% state of charge and alerts() where data gap from tedapi resulted in a null alert.
  • Add TEDAPI API call locking to limit load caused by concurrent polling.
  • Proxy - Add battery full_pack and remaining energy data to /pod API call for all cases.

v4.4.2 - Powerwall 3 Local Support

• Update to pypowerwall v0.10.4 to add support for Powerwall 3 using local Gateway only.
• Setup script adjusted to allow for Powerwall 3 local mode option.

v4.4.1 - FleetAPI Hotfix

• Update to pypowerwall v0.10.2 to fix FleetAPI setup but as raised in https://github.com/jasonacox/pypowerwall/issues/98.
• Update setup.sh to add optional command line switch -f for standalone FleetAPI mode setup.

v4.4.0 - FleetAPI and TEDAPI

• Add TEDAPI Support for Extended Device Metrics (the return of most of /vitals) - This requires connecting to Powerwall WiFi directly or setting up a network route on the Dashboard host to allow it to reach the GW address (192.168.91.1).
• Add support for Tesla’s official API, FleetAPI. This requires additional registration and configuration. Instructions are part of setup process or on the project page.
• Run upgrade.sh and then run setup.sh to choose these new options.
• Upgrade to pyPowerwall v0.10.0 proxy t58 - Release addresses some issues, including fixing Solar Only grid_status issues as reported by @lsgc123 in https://github.com/jasonacox/Powerwall-Dashboard/issues/478

• Fix setup.sh for docker group permission bug identified by @hulkster in #476

• Addresses several open issues and discussions:
  • https://github.com/jasonacox/Powerwall-Dashboard/discussions/392
  • https://github.com/jasonacox/Powerwall-Dashboard/discussions/402
  • https://github.com/jasonacox/Powerwall-Dashboard/issues/436
  • https://github.com/jasonacox/Powerwall-Dashboard/issues/472

v4.3.2 - Solar Only Fix

• Upgrade to pyPowerwall v0.8.5 proxy t56
• Fix bug with setup for certain Solar Only systems where clod mode process fails due to missing site_name. Identified by @hulkster in https://github.com/jasonacox/Powerwall-Dashboard/discussions/475

v4.3.1 - Control APIs

• Upgrade to pyPowerwall v0.8.4 proxy t55
• Fix /pod API to add time_remaining_hours and backup_reserve_percent for cloud mode.
• Dashboard: Removed Powerwall temperature panel in default dashboard (data is no longer available with latest Firmware)
• Added GET /control/mode and /control/reserve APIs to retrieve operating mode and back reserve settings
• Added POST /control/mode and /control/reserve APIs to set operating mode and back reserve settings. Requires running setup and setting PW_CONTROL_SECRET for pypowerwall in pypowerwall.env. Use with caution.

# Setup cloud mode for pypowerwall container
docker exec -it pypowerwall python3 -m pypowerwall setup -email=example@example.com

MODE=self_consumption
RESERVE=20
PW_CONTROL_SECRET=mySecretKey

# Set Mode
curl -X POST -d "value=$MODE&token=$PW_CONTROL_SECRET" http://localhost:8675/control/mode

# Set Reserve
curl -X POST -d "value=$RESERVE&token=$PW_CONTROL_SECRET" http://localhost:8675/control/reserve

# Read Settings
curl http://localhost:8675/control/mode
curl http://localhost:8675/control/reserve

v4.3.0 - pyPowerwall 0.8.2

• Upgrade to pyPowerwall proxy v0.8.2 - Major refactoring of code in https://github.com/jasonacox/pypowerwall/pull/77 and https://github.com/jasonacox/pypowerwall/pull/78 and addition of new Alerts.
• Disable GF_PATHS_PROVISIONING from grafana.env base to speed up Grafana startup by @BuongiornoTexas in #461

v4.2.1 - Docker V2 Fix

• Fixed upgrade.sh to support docker-compose (V2) command as discussed in #459.
• Updated setup.sh to check for Docker Compose V2.

v4.2.0 - Remove Docker V1

• Remove support for Docker V1 since it is obsolete. Upgrade progress will alert V1 users to upgrade to V2 before proceeding. Updates by @BJReplay in https://github.com/jasonacox/Powerwall-Dashboard/pull/454.

v4.1.3 - Alerts & Strings

• Updated to using pyPowerwall to v0.7.12 which brings some Alerts and String data back for systems with Firmware 23.44.0+. New library uses /api/solar_powerwall instead of now depreciated /api/devices/vitals by @DerickJohnson in https://github.com/jasonacox/pypowerwall/pull/75 and by @jasonacox in https://github.com/jasonacox/pypowerwall/pull/76.

v4.1.2 - Cache 404 Responses

• Updated pyPowerWall to v0.7.11 to add cache and extended TTL for 404 responses from Powerwall as identified in issue jasonacox/Powerwall-Dashboard#449 by @jgleigh. This will help reduce load on Powerwall gateway that may be causing rate limiting for some users (Firmware 23.44.0+).
• Updated logic to disable vitals API calls for Firmware 23.44.0+
• Added rate limit detection (429) and cooldown mode to allow Powerwall gateway time to recover.

v4.1.1 - Revert Change

• Problems identified with older docker-compose versions. Revering upgrade.sh changes but pushing new plugin list in grafana.env.sample for new installations.

v4.1.0 - Grafana Plugin Updates

• Update plugin list for Grafana, removing unneeded plugins (e.g. flux datasource) and adding logic to upgrade script to prune old grafana.env settings by @BuongiornoTexas in #442 #433

v4.0.5 - Dashboard Updates

• Updated timezone variable in dashboard.json to tz:text to ensure the Time Zone string is output as-is. This will make upgrading Grafana easier later on and future-proof the variables by @s-crypt in #439.
• Removed $tz from any queries that do not have a GROUP BY statement by @s-crypt in #439.
• Updated pyPowerWall Proxy t42 - Adds Power Flow Animation style (set PW_STYLE=”solar”) for Solar-Only display. Removes the Powerwall image and related text to display a Grid + Solar + Home power flow animation.

v4.0.4 - Cloud Grid Status

• Update to pyPowerWall v0.7.9 - Bug fix to render correct grid status for Solar-Only systems on cloud mode (see #437)

v4.0.3 - Cloud Mode Fixes

• Fix enumeration of energy sites during cloud mode setup to handle incomplete sites with Unknown names or types by @dcgibbons in https://github.com/jasonacox/pypowerwall/pull/72
• pyPowerwall Proxy t41 Updates - Bug fixes for Solar-Only systems using cloud mode (see https://github.com/jasonacox/Powerwall-Dashboard/issues/437).

v4.0.2 - Dashboard Update

• Update default dashboard.json to not connect null values over 1hr threshhold (corrctly representing data gaps) by @youzer-name in #430.
• Stack powerwall current energy values in Powerwall Capacity panel by @youzer-name in #430.
• Add “Off Grid” indicators to the bottom of the Frequency and Voltages panels by @youzer-name in #430.

v4.0.1 - Powerwall Voltages

• Added CQs and updated dashboard.json to include voltages from battery block vitals by @mcbirse in https://github.com/jasonacox/Powerwall-Dashboard/pull/426. This addresses users no longer seeing Powerwall voltages in the dashboard with firmware 23.44.0 or later - See related https://github.com/jasonacox/Powerwall-Dashboard/discussions/109#discussioncomment-8263020

v4.0.0 - Cloud Mode Support

• Using pyPowerwall for both Local Access and Tesla Cloud mode by @jasonacox and @mcbirse in https://github.com/jasonacox/Powerwall-Dashboard/pull/414 (replaces Tesla-history service, but the Tesla-history tool will continue to be used to fill in historic data or gaps) - See related https://github.com/jasonacox/pypowerwall/pull/59
• Removal of Docker Compose profiles (helps with some older systems that don’t fully support this) and the v1 related legacy support.
• Updated setup.sh and upgrade.sh to support transition to pyPowerwall for Tesla Cloud mode.
• Updated verify.sh to support Tesla Cloud mode.
• Updated dashboard for solar-only users to include Powerflow Animation panel.

v3.0.8 - Critical Bug Fix

• Fixes bug in pypowerwall proxy container version before jasonacox/pypowerwall:0.7.6t39 related to API calls and 404 HTTP status codes handling. Powerwall Firmware version 23.44.0 has eliminated /api/devices/vitals resulting in a 404 response from the Powerwall Gateway (TEG) when this is requested. There was a bug in the pypowerwall code that will treat this 404 like an authentication failure which will result in attempts to log in over and over, eventually hitting the rate limit. This is especially impactful for those using the proxy for things like Powerwall-Dashboard as the rate limit will prohibit other data gathering.

v3.0.7 - InfluxDB Environment Variables

• Add support to define InfluxDB configuration options by environment variable by @mcbirse. This allows the default configuration settings to be overridden and addresses https://github.com/jasonacox/Powerwall-Dashboard/discussions/408 raised by @youzer-name
• Change InfluxDB statistics recording to false by default to reduce CPU load by @youzer-name in https://github.com/jasonacox/Powerwall-Dashboard/pull/410
• Update example backup script to use tar.xz (-J option) by @s-crypt in https://github.com/jasonacox/Powerwall-Dashboard/pull/404 and https://github.com/jasonacox/Powerwall-Dashboard/pull/405 see https://github.com/jasonacox/Powerwall-Dashboard/issues/337
• [Tools] - default to bash in pwstatus script for better compatibility by @mcbirse see https://github.com/jasonacox/Powerwall-Dashboard/discussions/249#discussioncomment-7935882

v3.0.6 - Powerflow Animation Update

• Update to latest pypowerwall proxy t29:
• Default page loaded by proxy (http://localhost:8675/) will render Powerflow Animation. Animation assets (html, css, js, images, fonts, svg) will render from local filesystem instead of pulling from Powerwall TEG portal resulting in faster render time.

v3.0.5 - Bug Fix for MacOS

• README: fix “Powerall” typo in Powerwall 3 section by @kenyon in #399
• v3.0.4 - Fix upgrade.sh to address issue where get_profile() function incorrectly reads compose.env causing upgrade failure by @jasonacox in #401 Closes issue #400.
• v3.0.5 - Fix setup.sh, compose-dash.sh, verify.sh and weather.sh by @mcbrise in https://github.com/jasonacox/Powerwall-Dashboard/commit/45428ab56aa18ef2a04dce0f56e527b0a48c606d

v3.0.3 - Setup Profiles Updates

• Updated setup.sh process descriptions to include Tesla Cloud data source in profile options (see below). This is currently the only option for Powerwall 3 owners (see #387) by @mcbirse
• Update setup.sh to allow config changes.
• Added weather data to dashboard-no-animation.json dashboard.
• [Tools] - Revise pwstatus and weather-history retry handling by @mcbirse.

1 - Local Access (Powerwall 1, 2, or + using extended data from Tesla Gateway on LAN) - Default
2 - Tesla Cloud (Solar-only, Powerwall 1, 2, +, or 3 using data from Tesla Cloud)

v3.0.2 - Docker-Compose Fixes

• Add future deprecation WARNING for older docker-compose versions.
• Add support for docker-compose >= 1.28.0 to use compose profiles.
• Change logic in compose-dash.sh to default to Docker compose V2.

v3.0.1 - Fix for Docker-Compose V1

• This fixes an issue introduced by v3.0.0 for old Docker-Compose V1 systems in https://github.com/jasonacox/Powerwall-Dashboard/pull/389
• Updates example backup script to use xz compression in #337

v3.0.0 - Integrate Solar Only Support

• Added Solar Only support as a setup option when installing Powerwall Dashboard by @mcbirse in https://github.com/jasonacox/Powerwall-Dashboard/pull/386 see https://github.com/jasonacox/Powerwall-Dashboard/issues/183 and https://github.com/jasonacox/Powerwall-Dashboard/tree/main/tools/solar-only
• Updated Solar Only dashboard with user adjustable tz and cost variables, and removed Grid Status & Current State panels
• Updated Docker Compose environment to support compose profiles and updated setup, upgrade and verify scripts
• Added checks to setup script for common issues such as user/group problems
• Added migration for beta Solar Only installs to upgrade script

v2.10.0 - Docker Compose and Container Updates

• Update versions: Telegraf (v1.28.2) and pyPowerwall (v0.6.2t28)
• Updated to pyPowerwall Proxy t28 to support newer Grafana versions. Adds new PW_STYLE setting for grafana-dark mode.
• Updated setup.sh and upgrades.sh to support adding additional PW_STYLE setting.
• Docker Compose Config Improvements by @mcbirse - ref #366
• Update powerwall.yml to use variables for “user” and “ports” in containers, per #357 and #360 noted by @hulkster
• Updated compose.env.sample with explanation of latest supported options
• Updated powerwall.yml to use “unless-stopped” as the default restart policy for containers going forward

v2.9.12 - Weather411 and pyPowerwall Updates

• Fix weather411 to exit gracefully with SIGTERM by @rcasta74 in https://github.com/jasonacox/Powerwall-Dashboard/pull/354
• Update to pyPowerwall t27 to exit gracefully with SIGTERM.

v2.9.11 - Updated Default Dashboard

• Updated dashboard.json to isolate Powerwall+ string data to make it easier for those without Powerwall+ to close those empty panels as raised in https://github.com/jasonacox/Powerwall-Dashboard/issues/320. Also changed browser default timezone to TZ set by user.
• Dashboard-new formatting fixes and unlink library panels by @s-crypt in https://github.com/jasonacox/Powerwall-Dashboard/pull/316
• Fix dashboard.json in README by @longzheng in https://github.com/jasonacox/Powerwall-Dashboard/pull/319
• Update verify.sh to carry state of all tests back to calling shell by @vikrum in https://github.com/jasonacox/Powerwall-Dashboard/pull/321
• Fix mean in solar energy yr panel #330 by @jasonacox in https://github.com/jasonacox/Powerwall-Dashboard/pull/331
• Shared crosshair by @longzheng in https://github.com/jasonacox/Powerwall-Dashboard/pull/338

v2.9.10 - Updated Default Dashboard

• Updated default dashboard.json to incorporate timeseries migrations by @s-crypt in https://github.com/jasonacox/Powerwall-Dashboard/pull/295 and https://github.com/jasonacox/Powerwall-Dashboard/pull/297 see https://github.com/jasonacox/Powerwall-Dashboard/issues/290
• Updated “Grid Status” to new timeseries graph with red/yellow/green status.

v2.9.9 - Tools, Solar Only Support and Dashboard Updates

Instructions / Cleanup and Misc Tool Updates

• Fix typos and spelling errors by @mcbirse in https://github.com/jasonacox/Powerwall-Dashboard/pull/281
• Add instructions to make backup script executable by @s-crypt in https://github.com/jasonacox/Powerwall-Dashboard/pull/289
• Add timezone lookup instructions by @jasonacox see https://github.com/jasonacox/Powerwall-Dashboard/discussions/291#discussioncomment-6140863
• Remove option to set e-mail sender name in Powerwall Status Monitor tool for improved compatibility by @mcbirse in https://github.com/jasonacox/Powerwall-Dashboard/pull/301
• Update Powerwall Status Monitor tool to ignore null responses which can occur during firmware updates by @mcbirse in https://github.com/jasonacox/Powerwall-Dashboard/pull/305 see https://github.com/jasonacox/Powerwall-Dashboard/discussions/109#discussioncomment-6193560

Solar Only Support

• Add daemon option to Tesla History tool and create docker container by @mcbirse in https://github.com/jasonacox/Powerwall-Dashboard/pull/281
• Revise setup script to utilise docker container environment by @mcbirse in https://github.com/jasonacox/Powerwall-Dashboard/pull/283
• Add WinOS winpty support to setup script by @jasonacox in https://github.com/jasonacox/Powerwall-Dashboard/pull/283#discussion_r1201492026
• Add support to define InfluxDB PORT by environment variable when running in docker by @mcbirse in https://github.com/jasonacox/Powerwall-Dashboard/pull/285 see https://github.com/jasonacox/Powerwall-Dashboard/issues/183#issuecomment-1565191526
• Modify script to replace data instead of update by @mcbirse in https://github.com/jasonacox/Powerwall-Dashboard/pull/293 see https://github.com/jasonacox/Powerwall-Dashboard/issues/286

Powerwall-Dashboard Usage Micro Service

• New tool developed by @BuongiornoTexas to generate usage and cost/savings information based on utility usage plans in https://github.com/jasonacox/Powerwall-Dashboard/pull/299 see https://github.com/jasonacox/Powerwall-Dashboard/tree/main/tools/usage-service and https://github.com/jasonacox/Powerwall-Dashboard/issues/276
• Add Docker Hub upload script by @jasonacox in https://github.com/jasonacox/Powerwall-Dashboard/pull/299
• Remove armv7 architecture by @jasonacox see https://github.com/jasonacox/Powerwall-Dashboard/pull/299#issuecomment-1586136593

Migrate Dashboard Panels

• Create “dashboard-new” using new Grafana time series type panels by @s-crypt in https://github.com/jasonacox/Powerwall-Dashboard/pull/295 and https://github.com/jasonacox/Powerwall-Dashboard/pull/297 see https://github.com/jasonacox/Powerwall-Dashboard/issues/290

v2.9.8 - Tool Updates and Bug Fixes

• Update to Powerwall Status Monitor tool to prevent false grid status alerts during Powerwall firmware updates by @mcbirse as raised in https://github.com/jasonacox/Powerwall-Dashboard/discussions/109#discussioncomment-5801031
• Bug fix to Weather History Tool to resolve crash during setup process when weather411.conf is not found by @mcbirse

v2.9.7 - Backup Script Quickfix

• Quickfix for permissions issues after repo cleanup. This addresses permission issues that interrupt the upgrade script for users of the backup script. Fix by @YesThatAllen in https://github.com/jasonacox/Powerwall-Dashboard/pull/272 as raised in https://github.com/jasonacox/Powerwall-Dashboard/issues/265

v2.9.6 - Add Git Attributes

• Add .gitattributes file to help prevent issues such as .sh files being borked on Windows OS (ref #155) by @YesThatAllen in https://github.com/jasonacox/Powerwall-Dashboard/pull/270
• Fix verify.sh to run on Windows OS in https://github.com/jasonacox/Powerwall-Dashboard/commit/25b77e53310d1668b2b3868e59fac55b82286f

v2.9.5 - Repo Cleanup

• Repo cleanup and maintenance by @YesThatAllen in https://github.com/jasonacox/Powerwall-Dashboard/pull/269

v2.9.4 - pyPowerwall Proxy t26

• Update pyPowerwall Proxy to t26 with updated default PW_POOL_MAXSIZE of 15 as raised by @jgleigh and @mcbirse in https://github.com/jasonacox/Powerwall-Dashboard/discussions/261#discussioncomment-5803595
• Dashboard Update - Update “costs/credit per kWh” for buy vs. sell by @jgleigh in https://github.com/jasonacox/Powerwall-Dashboard/pull/266

v2.9.3 - Adjustable kWh Cost

• Dashboard Update - Make “costs/credit per kWh” and “timezone” user adjustable variables in Grafana by @emptywee in https://github.com/jasonacox/Powerwall-Dashboard/pull/266

v2.9.2 - Additional Powerwall Support

• Add support for up to 12 Powerwalls (added PW7 to PW12) for temperature data, frequencies, voltages and capacity as requested in https://github.com/jasonacox/Powerwall-Dashboard/discussions/253 and issue https://github.com/jasonacox/Powerwall-Dashboard/issues/256.

v2.9.1 - Minimize Grafana Plugins

• Minimize the number of default Grafana plugins as defined in the grafana.env.sample file (installed as localized grafana.env) for new installations by @jasonacox in https://github.com/jasonacox/Powerwall-Dashboard/issues/234
• Update power flow animation panel code to display Grafana loading image while power flow graphics are loaded by @dkerr64 as discussed in https://github.com/jasonacox/Powerwall-Dashboard/discussions/216#discussioncomment-5573094

v2.9.0 - Pinned Versions

• Tools - Reinstate setting timezone from history on 1st run by @mcbirse in https://github.com/jasonacox/Powerwall-Dashboard/pull/236
• Pinned versions in compose file for controlled upgrades and repeatable setups. Fix https://github.com/jasonacox/Powerwall-Dashboard/issues/237 issue by removing image pruning in upgrade.sh script by @GrimmiMeloni in https://github.com/jasonacox/Powerwall-Dashboard/pull/240

v2.8.11 - Animation Auto-Scale

• Add code to power flow animation dashboard panel to auto-scale based on window size by @dkerr64 in https://github.com/jasonacox/Powerwall-Dashboard/discussions/216

v2.8.10 - Revert Animation Auto-Scale

• Problem with scaling causing scrollbar and clipping reported and reproducible on Windows 11 as raised in https://github.com/jasonacox/Powerwall-Dashboard/discussions/216
• Tools - InfluxDB 2.x fixes and moved to grafana variables use instead of grafana.ini by @ThePnuts in #233

v2.8.9 - Animation Auto-Scale

• Solar Only Support Development - Fix timezone for solar only sites using an offset by @mcbirse in https://github.com/jasonacox/Powerwall-Dashboard/pull/226
• Add code to power flow animation dashboard panel to auto-scale based on window size by @dkerr64 in https://github.com/jasonacox/Powerwall-Dashboard/discussions/216 and PR https://github.com/jasonacox/Powerwall-Dashboard/pull/228
• Tools - InfluxDB 2.x updates to instructions and dashboard by @ThePnuts in https://github.com/jasonacox/Powerwall-Dashboard/pull/232

v2.8.8 - pyPowerwall Cache-Control

• Upgraded to pyPowerwall v0.6.2 Proxy t25 which fixes Cache-Control no-cache header and adds an option to set max-age, See https://github.com/jasonacox/pypowerwall/blob/main/proxy/RELEASE.md#proxy-t25-21-mar-2023
• Solar Only Support Development by @mcbirse in https://github.com/jasonacox/Powerwall-Dashboard/pull/211 and in https://github.com/jasonacox/Powerwall-Dashboard/pull/218 in https://github.com/jasonacox/Powerwall-Dashboard/tree/main/tools/solar-only
• Grafana Options - Base setup in grafana.env.sample will allow embedding of graphs into webpages #219 and optional removal of login requirement #221
• Tools - InfluxDB 2.x optional setup, tasks, and dashboard by @ThePnuts in https://github.com/jasonacox/Powerwall-Dashboard/pull/223 See https://github.com/jasonacox/Powerwall-Dashboard/tree/main/tools/influxdb2

v2.8.7 - Preserve Peaks in Graphs

• Update Live Monitoring graph queries for Dashboard to use max() instead of mean() for Solar, Home, Grid and Powerwall to preserve peaks across all time filters as raised in https://github.com/jasonacox/Powerwall-Dashboard/issues/203
• Update pyPowerwall proxy service to v0.6.1 Proxy t24 (see https://github.com/jasonacox/pypowerwall/releases/tag/v0.6.1)

v2.8.6 - Weather Updates

• Weather411 v0.2.0 - Upgrade InfluxDB Client to support InfluxDB 1.8 and 2.x by @jasonacox in https://github.com/jasonacox/Powerwall-Dashboard/pull/196 closes https://github.com/jasonacox/Powerwall-Dashboard/issues/195 re: https://github.com/jasonacox/Powerwall-Dashboard/discussions/191#discussioncomment-5112333
• README Improvements by @BJReplay in https://github.com/jasonacox/Powerwall-Dashboard/pull/192
• Ecowitt Weather v0.2.2 - Upgrade InfluxDB Client to support InfluxDB 1.8 and 2.x by @BJReplay in https://github.com/jasonacox/Powerwall-Dashboard/pull/200

v2.8.5 - Verify Tool for Setup

• Added verify.sh tool to test setup and operation of the main components for the Dashboard (pypowerwall, telegraf, influxdb, grafana, weather411) by @jasonacox as raised in https://github.com/jasonacox/Powerwall-Dashboard/issues/187

./verify.sh # optional: -no-color

v2.8.4 - Custom Docker Compose Support

• Added support for extending docker-compose setup via powerwall.extend.yml by @BJReplay in https://github.com/jasonacox/Powerwall-Dashboard/pull/186
• Renamed backup.sh to backup.sh.sample to allow local settings changes without impacting upgrade by @BJReplay in https://github.com/jasonacox/Powerwall-Dashboard/pull/186

v2.8.3 - New Dashboard Meters

• Added “Net Grid Usage” meter by @wreiske and “% Solar Powered” meter by @jasonacox in https://github.com/jasonacox/Powerwall-Dashboard/issues/179 https://github.com/jasonacox/Powerwall-Dashboard/pull/181
• Dashboard archived and versioned in ./dashboards
• Moved Alert Data from 3 day retention policy to separate “alerts” infinite (INF) retention policy.

v2.8.2 - Bug Fix Grid Voltage Data Migration

• Grid Voltage Upgrade - This will fix the run-once script so tags are also copied with historic data by @mcbirse in https://github.com/jasonacox/Powerwall-Dashboard/pull/177

Note: For anyone that already upgraded to 2.8.0 or later, there is an option to fix the untagged data by running the Fix Month Tags Tool. Thanks to @mcbirse for spotting this issue, submitting the fix and the great fixmonthtags tool!

v2.8.1 - Backup Reserve

• Add Powerwall backup reserve setting (%) to Energy Usage graph thanks to @mp09 in https://github.com/jasonacox/Powerwall-Dashboard/issues/174

v2.8.0 - Grid Voltage Upgrade

• Now using ISLAND_VLxN_Main data for Grid voltage (instead of METER_x_VLxN) as this appears to be more common across systems. Upgrade script executes a run-once query to copy historic data over. https://github.com/jasonacox/Powerwall-Dashboard/pull/167
• Added logic to Voltage panel to sum Powerwall L1 and L2 voltages for 230V grid users thanks to @longzheng in https://github.com/jasonacox/Powerwall-Dashboard/pull/165
• Change frequency panel to 3 decimal places by @longzheng in https://github.com/jasonacox/Powerwall-Dashboard/pull/163
• Update README.md - Indent powerwall.yml snippet so that it can be cut and pasted directly into powerwall.yml by @BJReplay in https://github.com/jasonacox/Powerwall-Dashboard/pull/168

v2.7.1 - Powerwall Alert Data and Panel

• Add Powerwall Alert data to dashboard - Credit to @DerickJohnson in https://github.com/jasonacox/Powerwall-Dashboard/issues/158
• Updated Tools and Contrib READMEs by @BJReplay in https://github.com/jasonacox/Powerwall-Dashboard/pull/160

v2.7.0 - PyPowerwall t24 and Ecowitt Weather Support

• [Ecowitt Weather] Added Ecowitt local weather station data import service and dashboard by @BJReplay in https://github.com/jasonacox/Powerwall-Dashboard/pull/150 https://github.com/jasonacox/Powerwall-Dashboard/pull/151 https://github.com/jasonacox/Powerwall-Dashboard/pull/153 https://github.com/jasonacox/Powerwall-Dashboard/pull/157
• [Tesla History Tool] Revise error handling of SITE_DATA request by @mcbirse in https://github.com/jasonacox/Powerwall-Dashboard/pull/156
• [Ecowitt Weather History Tool] Added Ecowitt Weather History Tool by @BJReplay in https://github.com/jasonacox/Powerwall-Dashboard/pull/159
• [pyPowerwall Proxy] Upgraded to pyPowerwall Proxy t24 which moves to Python 3.10 and adds /alerts/pw for easier alert history tracking by @DerickJohnson in https://github.com/jasonacox/pypowerwall/pull/26

v2.6.7 - History Tools and Powerwall Firmware Version

• Add Powerwall Firmware version to Power-Flow animation. #112
• Fix Self-Powered calculations to factor in Grid charging of Powerwall. #135
• Upgrade to pyPowerwall Proxy t22 to better handle Powerwall Firmware updates. This introduces no-cache headers and hopefully eliminates the need for proxy restart. #112
• Fix timezone script (tz.sh) to process file in the dashboards folder. https://github.com/jasonacox/Powerwall-Dashboard/issues/63
• Eliminate horizontal scrollbars on iPhone. by @cwagz in https://github.com/jasonacox/Powerwall-Dashboard/pull/114
• Updated animation and yearly image by @cwagz in https://github.com/jasonacox/Powerwall-Dashboard/pull/117
• Tesla History Tool - Fix bug with error output when dateutil is missing by @mcbirse in https://github.com/jasonacox/Powerwall-Dashboard/pull/123
• Fix Month Tool - Added tool to fix incorrect month tags of InfluxDB by @mcbirse in https://github.com/jasonacox/Powerwall-Dashboard/pull/124 and https://github.com/jasonacox/Powerwall-Dashboard/pull/126
• Weather History Tool - Added tool to retrieve weather history data by @mcbirse in https://github.com/jasonacox/Powerwall-Dashboard/pull/147

v2.6.6 - History Import Tool & Windows 11 Compatibility

• Added tool to import history data from Tesla cloud by @mcbirse in https://github.com/jasonacox/Powerwall-Dashboard/pull/99 and https://github.com/jasonacox/Powerwall-Dashboard/pull/108 - see https://github.com/jasonacox/Powerwall-Dashboard/tree/main/tools#tesla-historypy and https://github.com/jasonacox/Powerwall-Dashboard/issues/12
• Adjusted instructions, setup.sh and upgrade.sh to work with Windows 11 OS. https://github.com/jasonacox/Powerwall-Dashboard/issues/63
• Minor QoL enhancements by @BuongiornoTexas in https://github.com/jasonacox/Powerwall-Dashboard/pull/105 - Closes https://github.com/jasonacox/Powerwall-Dashboard/issues/96

v2.6.5 - Upgrade pyPowerwall Proxy t18

• Upgrade to pyPowerwall Proxy t18 with enhanced error handling and logging
• Update backup.sh to validate directories before starting backup process #85
• Fix panel size for Animation to prevent scroll/clipping of data #98

v2.6.4 - Upgrade Fix

• Upgrade issue identified in #85 that keeps files from updating (upgrade fails). New method will stash and rebase all but non-tracked files (e.g. grafana.env and pypowerwall.env local config files).

v2.6.3 - Dashboard Updates

• Converts the “Energy Usage” graph to a new Grafana 9 time series graph - dashboard.json by @youzer-name in https://github.com/jasonacox/Powerwall-Dashboard/pull/86
• Add timezone to telegraf so tags are localized by @mcbirse in https://github.com/jasonacox/Powerwall-Dashboard/pull/81

v2.6.2 - Current State Panel “No Data” Fix (No Archive)

• Fix bug in yesoreyeram-boomtable-panel that causes random “No data” errors in table. This uses the v1.5.0-alpha.3 boomtable by @yesoreyeram. #49

v2.6.1 - Month and Year Tag Fix (No Archive)

• Add timezone to telegraf so tags are localized by @mcbirse in https://github.com/jasonacox/Powerwall-Dashboard/pull/81
• Fix dashboard.json bugs and update the rest of dashboard-*.json files for Grafana v9.

v2.6.0 - Grafana v9.1.2 Upgrade

• Update dashboards and setup to use Grafana v9.1.2 by @techlover1 in https://github.com/jasonacox/Powerwall-Dashboard/pull/73
• Bug fix missing space in weather.sh by @mcbirse in https://github.com/jasonacox/Powerwall-Dashboard/pull/72

v2.5.2 - Bug Fix

• Fix upgrade.sh to prevent sudo/root from running this script. #42

v2.5.1 - Bug Fix

• Fix bug in weather.sh that causes the script to error on location entry. #72

v2.5.0 - Weather Data

• Adds local weather data from OpenWeatherMap.org using the jasonacox/weather411 container. #42 #51

v2.4.5 - pyPowerwall v0.6.0

• Upgraded to pyPowerwall v0.6.0 Proxy t17 - Persistent HTTP Connections
• Added setup warning. Raspbian GNU/Linux 10 (buster) has a bug in the libseccomp2 library that causes the pypowerwall container to fail. See details an fix in #56

v2.4.4 - Dashboard Updates

• Fixed Current State panel so it is not affected by different time range selections, and “No Data” issue by @mcbirse in https://github.com/jasonacox/Powerwall-Dashbsoard/pull/50
• Made the power flow animation dashboard the default (dashboard.json). Original dashboard is still available as dashboard-no-animation.json.

v2.4.3 - Upgrade Fixes

• Externalize Grafana environment settings into grafana.env to allow for additional customizations.
• Update and fixes to setup.sh and upgrade.sh.

v2.3.0 - Bug Fixes

• Fix pypowerwall.env format and timezone bug in setup #23
• Add check in setup.sh to ensure not running as root/sudo.
• Added self-upgrade feature to upgrade.sh with set -e to stop on errors #45
• Added VERSION tracking to help with upgrades (upgrade.sh and setup.sh).

v2.2.0 - Power Flow Animation

• Added new Grafana dashboard and panel for iFrame for pyPowerwall Proxy passthrough Power Flow Animation - see dashboard-animation.json.
• Fixed Timezone management for tz.sh, setup.sh and upgrade.sh for easier repeat setup and upgrades. #23

v2.0.0 - Frequency and Voltage Graphs

• Add graph
• pyPowerwall v0.4.0

v1.0.0 - Initial Release

• Initial Release
• Tested on Ubuntu 18.04.6 LTS, Ubuntu 18.04.6 and 20.04 LTS, Raspberry Pi OS 32-Bit Debian Bullseye (armv7) and MacOS (x86_64, arm64)
• pyPowerwall v0.3.0