Help & Troubleshooting
The most common cases, each with the shortest path to a fix. If nothing matches: get in touch.
Guided Troubleshooting
The app can't find my gateway
Connection, network, activation code: the path from "no connection" to a green status.
A device is missing or shows no data
Why a device doesn't show up, and the difference between "not detected" and "detected, but silent."
Values look wrong
Battery supposedly charging while discharging, implausible self-sufficiency, solar negative at night: measurement issues and their fixes.
The wallbox isn't charging
From plug to charge limit: the checklist, in order of the most common causes.
Device offline after router restart
When the router has handed out new IP addresses: what Franzl heals itself, and where you need to step in.
Frequently Asked Questions
What do I need to use Franzl? Home Assistant (e.g. on a Raspberry Pi or Home Assistant Green) with the Franzl Gateway, at least one supported energy device, and the free app. Details: Requirements.
Do I have to type in the activation code? Usually not. If your phone is on the same Wi-Fi as your Home Assistant, the app finds the gateway by itself and picks up the code — all you do is tap "Activate". Typing it in or scanning the QR code remains available, just in case and for activating remotely. How pairing works.
Why does the app ask for local network access on iPhone? Because otherwise it can't see your gateway on Wi-Fi. Franzl looks for it directly on your network so the connection doesn't have to detour through the internet — that's faster, and it still works when your internet is down. The permission isn't used for anything else. Declined by accident? iOS Settings → Franzl → turn on "Local Network".
The app says "No Franzl box visible on Wi-Fi right now". Is something broken? No. It only means the automatic search can't see anything at the moment — some networks (guest Wi-Fi, strict router settings) don't pass such search requests along. Activation then works perfectly normally with the code from the Franzl panel.
Where do I find my version numbers? In the app under More → Software & updates. The Franzl App (on your phone), the Franzl Gateway (on your box), Home Assistant and the operating system are listed there, along with any available updates. The app version is also shown at the very bottom of the More tab.
Does Franzl cost anything? The full monitoring and manual control are free. The autopilot — Franzl planning and controlling around the clock on his own — is unlocked for everyone for the launch as well: see Pricing.
Does Franzl work without internet? Yes, optimization and control keep running locally on your gateway. Without internet you only lose remote access, push notifications, solar forecast updates, and spot market prices (Franzl then plans with the last data it loaded).
How do I cancel my Pro subscription? Directly through your app store: iPhone → Settings → Apple Account → Subscriptions, or Google Play → Profile → Payments & subscriptions.
How do I delete my account? In the app (More → Delete account) or via the Delete account page.
My device brand is missing from the list. Is it coming? Send us the manufacturer and model at hi@getfranzl.com, and we'll tell you if and when. The device database grows with every release.
I found a security vulnerability. Thanks for reporting responsibly: hi@getfranzl.com (subject "Security").
Didn't find what you needed?
Write to hi@getfranzl.com with your version numbers (in the app under More → Software & updates) and what you've already tried. We usually reply within 1–2 business days; Pro subscribers get priority.