Connect Your System

You can view mock data now, and switch to live Victron VRM / PVOutput data when you have access to a site.

Mock Mode (default)

  1. Set VICRON_MOCK=1 in your environment.
  2. Open /api-dashboard to see sample values update every ~20s.

Victron VRM Setup

  1. Create a free VRM account and generate a Personal Access Token (VRM → Preferences → Integrations → Access tokens).
  2. Ask the site owner (or your own device) to add your VRM user to their installation.
  3. Find your Installation ID (idSite) from the VRM URL or via the API.
  4. Optionally add these env vars and redeploy (for server‑wide config):
    VICRON_MOCK=0
VICTRON_VRM_TOKEN=<your_personal_access_token>
VICTRON_VRM_SITE_ID=<idSite>

Stored encrypted on our server. Never exposed to the browser after save.

We never expose your VRM token to the browser; the dashboard calls a server proxy at /api/integrations/victron/summary.

PVOutput Setup (optional)

  1. In PVOutput, enable API and copy your API Key (Settings → API Access).
  2. Copy your System ID (shown in Settings → Registered Systems).
  3. Paste them below to save (encrypted) for your user. The dashboard will read current power/energy via PVOutput.

Stored encrypted on the server. Never exposed to the browser after save.

View on PVOutput

We never expose your PVOutput key to the browser; the dashboard calls a server proxy at /api/integrations/pvoutput/summary.

Troubleshooting

  • Empty VRM installations list → your VRM account isn’t linked to a site yet.
  • PVOutput 400 No status found → add a sample reading or wait for uploads.
  • 401/403 from APIs → double‑check headers and IDs; our server caches some responses to avoid rate limits.
Local Solar Payback & Incentive Tracker