Docs
What's new

Welcome to Svitgrid

In short

Svitgrid watches your solar system and tells you where your electricity comes from, where it goes, and what it costs.

Your solar inverter already knows everything: how much the sun is making, how full the battery is, whether the grid is up. It just keeps it to itself, on a small screen in a cupboard.

Svitgrid reads that information and puts it on your phone. Then it goes further — it can tell the inverter what to do, on a schedule you set.

What Svitgrid does

  • Shows you live power. Solar, battery, grid and house, updating while you watch.
  • Keeps the history. Days, weeks, months and years, so you can compare this January with last January.
  • Counts the money. What you paid the grid, what the grid paid you, what your green tariff earned.
  • Predicts tomorrow. A solar forecast built from your roof's real angle and the weather.
  • Runs your inverter for you. Charge the battery when power is cheap. Sell when it is expensive. Fill the battery before a scheduled blackout.
  • Tells you when something breaks. A dead string, an offline inverter, a battery heading for empty.

What Svitgrid is not

Svitgrid is monitoring and scheduling software. It is not a safety device and not a replacement for your inverter's own protection. Never rely on it to prevent damage to equipment or to keep critical medical or life-safety equipment running.

Who it is for

Anyone with a compatible solar inverter — see Supported inverters. Most of Svitgrid's users are in Ukraine, so it also understands Ukrainian electricity tariffs and blackout schedules. The rest of the app works anywhere.

How to read these docs

Each page starts with an In short box. If that answers your question, you are done. Under it is the step-by-step. Grey More detail boxes hold the exhaustive version — open them only when you need the exact numbers.

If you are new, read these four pages in order:

  1. How Svitgrid works — the one idea everything else rests on
  2. Download and install
  3. Create your account
  4. Setting up your system

How Svitgrid works

In short

Something on your home network reads your inverter and sends the numbers to Svitgrid. You choose what that something is: your phone, a small Svitgrid box, or Home Assistant.

Your inverter is not on the internet. It sits on your home Wi‑Fi and answers questions from anything on the same network.

So Svitgrid needs a collector — something at home that asks the inverter for numbers and forwards them to the Svitgrid cloud. Your phone then reads them from the cloud, wherever you are.

  inverter  ──►  collector  ──►  Svitgrid cloud  ──►  your phone
 (your home)   (your home)         (internet)         (anywhere)

Everything else in Svitgrid — charts, money, forecasts, schedules — is built on that one flow. Which collector you pick decides how complete your data is.

The three collectors

Your phoneSvitgrid GatewayHome Assistant
CostFree999 ₴ onceFree, if you already run HA
Collects when you are outNoYesYes
Collects at nightOnly if the app is openYesYes
Typical coverage2–4 hours a day24/724/7
Control the inverterYes, at home onlyYesYes
Zigbee sockets, EV chargerNoYesNo
Read a battery BMSYes, while the screen is onYes, alwaysNo
Works with no internetNoNoYes (local mode)

Which should I choose?

If you own a Svitgrid Gateway, use it — it is the only option that never has gaps. If you already run Home Assistant, use that. Your phone is a fine way to start, but it can only see your system while you are standing in the house with the app open, so your charts will have holes in them. See Data quality.

Why gaps matter

A collector that only runs sometimes does not just lose those hours — it quietly ruins the numbers built on them. Your daily total is short, your solar forecast learns from an incomplete picture, and a scheduled event cannot run if nothing is at home to run it.

What happens in the cloud

The cloud stores your readings, adds up daily and monthly totals, prices them against your tariff, runs the forecast, and decides when a scheduled event should fire. It also sends your notifications.

More detail — how long data is kept
WhatKept for
The live readingAlways current, overwritten each time
5‑minute detail7 days
Hourly detail90 days
Daily, weekly and monthly totalsForever

So a chart of last week is built from 5‑minute data, a chart of last month from hourly data, and a chart of 2024 from daily totals. Zooming into a single day two years ago will show the day's total, not its minute-by-minute shape.

Download and install

In short

Get the app from the App Store or Google Play, then allow notifications so Svitgrid can warn you about blackouts and faults.

iPhone and iPad

  1. Open the App Store.
  2. Search for Svitgrid.
  3. Tap Get.

Requires iOS 15 or newer.

Android

  1. Open Google Play.
  2. Search for Svitgrid.
  3. Tap Install.

Requires Android 7 or newer.

Permissions Svitgrid asks for

Svitgrid asks for each of these only when it first needs it, and explains why at the time. You can refuse any of them and the rest of the app keeps working.

PermissionWhyIf you say no
NotificationsBlackout warnings, faults, low batteryYou get no alerts at all
Local network (iOS)To find and read your inverter over Wi‑FiYour phone cannot collect data
BluetoothTo set up a Svitgrid Gateway, or read a battery BMSYou cannot pair a Gateway from this phone
LocationTo place your house for the solar forecastYou can type the address instead

Turn notifications on. A scheduled blackout warning is the single most useful thing Svitgrid sends, and it is worthless if it cannot reach you.

Keeping the app up to date

Turn on automatic updates. Svitgrid changes quickly, and some fixes need both the app and the server. If your app is far too old to work correctly, Svitgrid blocks it on launch and asks you to update — that screen means your version is no longer supported, not that something is broken.

Create your account

In short

Sign up with an email address, Google or Apple. One account can hold several homes and can be shared with your family.

Register

  1. Open Svitgrid and tap Create account.
  2. Enter your email and a password of at least 8 characters.
  3. We email you a 6-digit code. Type it into the app to confirm your address.

It is a code, not a link

Every email Svitgrid sends you — sign-up, password reset, approving a new phone — contains a short code that you type into the app. There is no link to click, so it does not matter which device opens the email.

Codes are valid for 15 minutes. If yours has expired, ask for a new one rather than retyping the old.

Sign in with Google or Apple

Faster, and there is no password to forget. Use the same one every time — signing in with Google and then later with email creates two separate accounts, and your home will only be in one of them.

If your household disappears after signing in, you have almost certainly signed in through a different provider than the one you registered with. Sign out and try the other one before creating anything new.

Forgotten password

Tap Forgot password on the sign-in screen. We email you a 6-digit code; type it in and choose a new password.

Two-factor authentication

Under Settings → Account → Security you can require a second code at sign-in. Turn this on if other people can reach your email.

Store your recovery codes somewhere safe and offline. If you lose both your second factor and your recovery codes, nobody at Svitgrid can unlock the account for you.

Deleting your account

Settings → Account, then the danger zone at the bottom. This removes your account and the homes you own. It cannot be undone.

Setting up your system

In short

A wizard walks you through naming your home, choosing how data is collected, finding your inverter, and describing your battery and panels.

The first time you sign in, Svitgrid asks a series of questions. None of it is permanent — every answer can be changed later in Settings.

Step 1 — Name your home

Anything you like: Home, Dacha, Mum's house. If you look after more than one property, the name is how you tell them apart.

You also pick a picture for the house — a cottage, an apartment block, a ground-mounted array with no building at all. It appears on your dashboard behind the weather.

Step 2 — Where it is

Used for two things: the solar forecast needs to know where the sun will be, and Ukrainian blackout schedules are organised by region.

Let the app use your location, or type the address.

Step 3 — How data is collected

Choose your collector — this is the choice explained in How Svitgrid works.

  • This phone — free, works immediately, only collects while you are home with the app open.
  • Svitgrid Gateway — a small box that collects 24/7.
  • Home Assistant — if you already run it.

Step 4 — Your inverter

Pick the brand, then the model. Svitgrid supports 80 models across 18 brands — see Supported inverters.

Can't find your exact model?

Search the model number printed on the inverter's front label. Many inverters are the same machine sold under different names, and the search box knows those aliases — typing Sunsynk or Easun will find the entry you need even when the brand list does not show that name.

Step 5 — Connecting to the inverter

What Svitgrid needs here depends on the brand. Most commonly it is the inverter's IP address on your home network plus the serial number of the Wi‑Fi logger stick plugged into it. Some brands need neither. See Connecting to your inverter for how to find both.

Svitgrid can usually find the inverter by scanning the network, so try Scan before typing anything.

Step 6 — Battery and panels

Tell Svitgrid what you actually own:

  • Battery — chemistry (usually LiFePO4), capacity in kWh, and whether two inverters share one battery bank.
  • Panels — how many strings, their total kWp, which way they face and their tilt.

The panel answers feed the solar forecast. Rough numbers are fine; you can correct them later.

Step 7 — Pair the Gateway

Only if you chose the Gateway. Svitgrid finds it over Bluetooth, then asks for your Wi‑Fi name and password so the box can reach the internet on its own. See Svitgrid Gateway.

Step 8 — Check and finish

A summary of everything. Confirm, and the dashboard opens.

Your first readings should appear within a minute or two. If the dashboard sits empty, go straight to Troubleshooting — it is nearly always the IP address or the logger serial.

Dashboard

In short

The home screen draws your energy as it moves right now — from the sun, into the battery, out to the house, to and from the grid.

The dashboard is two pages. The first is the diagram; swipe up for your charts. Pull down anywhere to refresh.

The energy diagram

Four things surround your house, and lines connect them. Power travels along each line as a moving pulse, so you can see direction at a glance.

  • Sun — what the panels are making right now.
  • Battery — how full it is, and whether it is charging or draining.
  • Grid — power coming in, or going out. Negative means you are exporting.
  • House — what your home is using.

Reading it in one second

Pulses flowing toward the house mean something is feeding you. Pulses flowing away from the house, toward the grid, mean you are selling.

Tap any of the four to open a detail card with more context — including what today's grid import and export have actually cost or earned on your tariff.

The cards below

  • Battery — charge level, power in or out, and how long it will last. The countdown stops at your inverter's own cut-off level, not at 0%, because that is when your house actually goes dark.
  • Grid — voltage, import and export, priced for today.
  • Solar — per-string output. Four or more strings fold into a compact grid.
  • Generator port — only if your inverter has one in use. See Smart load and generator port.

On your home screen, outside the app

Svitgrid has a home-screen widget for Android and iOS showing live power without opening the app. The Android widget also has a refresh button.

Banners

Short messages above the diagram, each appearing only when it applies: firmware updating, data looks stale, battery not configured, a scheduled blackout is coming, solar is being curtailed because the battery is full and there is nowhere for the power to go.

Homes with several inverters

Svitgrid draws a diagram that fits however many inverters you have, and the totals are summed from exactly the inverters shown. A filter bar at the top lets you look at one inverter at a time, and a table view compares them side by side.

If two inverters share one physical battery bank, say so in Inverter settings — otherwise the same battery is counted twice.

How often it updates

New readings arrive as fast as your collector sends them, and that rate is a setting rather than a fixed speed. Look for Cloud reporting — "how often this system reports to the cloud" — on your collector's own screen: Harvest for a phone, Edge device for a Gateway, or Home Assistant. You can set anywhere from 30 seconds to 5 minutes.

The fastest step you may choose depends on your plan: 30 seconds on Plus and Pro, 60 seconds on Basic. A longer interval is gentler on a phone's battery and on your data allowance.

If the dashboard feels slow, check this setting before assuming a fault

A 5-minute interval is a perfectly healthy system reporting exactly as configured.

Data can only be as fresh as your collector

If your phone is the collector, the dashboard is live only while you are home with the app open. Away from home it shows the last reading collected, with a "stale data" banner. This is not a fault — see How Svitgrid works.

Battery

In short

A screen of its own: charge level, how long it will last, each physical pack you own, and — if you have a compatible BMS — the voltage of every individual cell.

Open it by tapping the battery on the dashboard.

What you see

  • State of charge — how full, as a percentage.
  • Power — how fast it is charging or draining, in watts.
  • Runtime — how long until it reaches your inverter's cut-off point at the current rate. Shown as "more than 48 hours" when the drain is very slow.
  • Packs — one card per physical battery you own.
  • Cells — per-cell voltages, if a battery monitor is connected.

Why runtime is shorter than you expect

Svitgrid counts down to the level your inverter stops at, not to zero. If your inverter is set to keep 30% in reserve, a battery showing 50% has only 20% of usable energy left. That is the honest number.

Packs

If your installation has several batteries, each is a card. Give them names — Garage, Left rack — so a warning about one tells you which one to walk to.

Svitgrid compares what you configured against what the battery actually reports, and shows the disagreement on the card rather than silently trusting either.

Cells

With a battery monitor connected, Svitgrid shows every cell's voltage, the spread between the best and worst cell, temperatures, and whether the balancer is working. See Battery monitors for which monitors are supported and how to connect one.

The screen leads with a plain verdict — Battery is healthy, Cells are drifting apart, One cell is falling behind, Too cold to charge, Readings cannot be trusted.

A blank is not a zero

If Svitgrid cannot measure something, it leaves it blank instead of showing 0. A reading that fails its own consistency check is withheld rather than displayed. Being visibly missing beats being quietly wrong.

Charts and reports

In short

The history of your system: how much you generated and used, split by source, and what it all cost or earned.

Reached from the Charts tab. Two sub-tabs: Overview and Finance.

Choosing a period

Week · This month · Last month · Year · or a custom range. Everything on both tabs follows the period you pick.

Overview

  • Totals — generated, consumed, imported, exported for the period.
  • Where your power came from — solar, battery and grid as a split bar.
  • Production heatmap — a grid of days and hours. A genuinely zero hour and an hour where nothing was collected are drawn differently, so a gap in your data never masquerades as a night.
  • Hourly profile — for today, the shape of the day so far.
  • Battery charge curve — how full the battery was across the period.
  • Change vs the period before — this week against last week.

Finance

  • What you paid the grid, on your real tariff including day and night zones.
  • What you earned exporting.
  • Green tariff settlement — the month it covers, and what it worked out to.
  • Savings — what the solar system saved you against buying everything from the grid.

All of it depends on having your tariff set up correctly. See Electricity tariff.

Compare

Puts this period next to the previous one: generated, consumed, imported, exported, peak solar, peak load, net saving.

Export to CSV

Writes the selected period to a spreadsheet file you can open in Excel or send to your accountant.

Where the numbers come from

Reports are built from stored history, and stored history only exists for hours your collector was running. A month with a week of missing collection will read low, and no amount of refreshing will fill it in. See Data quality.

Full-screen display

In short

Turn the phone or tablet sideways for a big, room-readable display — useful on a wall or a spare tablet in the kitchen.

Open it from the dashboard and rotate the device.

You get one large gauge and four tiles — Solar, Battery, Grid, House — in type big enough to read across a room. Under Solar, each panel string's voltage and current is listed.

An old tablet on a charger in the hallway makes a good permanent energy display. If that tablet is also your collector, keep the app open and the screen awake.

There is also a full-screen forecast strip, reached the same way from the Solar forecast screen, which you can pan across several days.

Notifications and alerts

In short

Svitgrid tells you when the power goes out, when it comes back, when the battery is heading for empty, and when your equipment stops answering.

The alerts you can get

AlertMeaning
Power outageThe grid has gone down
Grid restoredIt is back
Inverter offlineYour equipment has stopped reporting
Inverter unreachableThe collector cannot reach the inverter
Low battery / Critical batteryCharge has crossed your threshold
Battery fullCharging finished
Battery heading for emptyThe forecast says you will run out
Inverter errorThe inverter is reporting a fault
String offlineOne panel string has stopped producing
Outage readinessA scheduled blackout is coming and your battery is low
Scheduled event started / endedOne of your calendar events ran
Daily / weekly summaryA digest, off by default
Monthly value reportWhat Svitgrid was worth to you last month

Every alert explains itself

Tapping an alert opens a page that shows the evidence — the actual battery level next to the threshold it crossed, how long the equipment has been silent, the day's total. Not a field name and a number.

Underneath is What you can do: concrete one-tap actions. A low battery on a two-zone meter, for example, offers to charge tonight instead of now, and shows you both prices before you agree.

Actions that change your inverter show you exactly what will change and ask for confirmation. Nothing is written to your equipment without you tapping to approve it.

Settings

Settings → Notifications.

  • Per-category switches — mute the ones you do not care about.
  • Daily summary — off by default, with a time you choose.
  • Weekly summary — off by default, Mondays.
  • Quiet hours — off by default, 22:00 to 07:00 when on.
  • Monthly value report — on by default.
  • Product updates — on by default.

Urgent alerts ignore quiet hours

A power outage, an inverter error, an offline inverter and a battery-heading-for-empty warning will still wake you. That is deliberate — those are the ones worth waking for.

Not getting notifications?

  1. Check the master switch in your phone's own settings, not just Svitgrid's.
  2. Check the category is not muted.
  3. Check quiet hours.
  4. On Android, check battery optimisation is not suspending Svitgrid.

Solar forecast

In short

Svitgrid predicts how much your panels will make over the next few days, using the weather and the real angle of your roof.

Open it from the Forecast button in the bottom bar.

What you see

  • Today's curve with a shaded band around it. The band is the uncertainty: narrow means confident, wide means the weather could go either way.
  • The next few days as a strip you can tap through.
  • How accurate we have been — yesterday's forecast against what actually happened.
  • Unrealised generation — power your panels could have made but did not, usually because the battery was full and there was nowhere to put it.
  • Battery outlook — hourly bars showing where your charge is heading.

Turn the phone sideways for a full-screen strip you can pan across several days.

How it works

Svitgrid combines the weather forecast for your exact location with what it knows about your system: how many kilowatts of panels, which way they face, their tilt, and how they have actually behaved on similar days.

That last part matters most. The forecast learns from your roof. A system with a tree shading it at 4pm will, after a couple of weeks, have that dip built into its prediction.

Making it accurate

Check Settings → Inverter settings → Solar configuration:

  • kWp — total panel power. On the panel label, multiply the watts by how many you have.
  • Azimuth — the compass direction the panels face. South is 180°. There is a compass tool: stand facing the same way as the panels and read it off.
  • Tilt — the angle from flat. A typical pitched roof is 30–35°.

Set each string separately if they face different ways.

A new forecast needs about two weeks

Until then it works from the weather and your stated angles alone. Accuracy improves as it learns.

The forecast is cloud-computed. If you run Home Assistant in local mode with cloud sync switched off, there is no forecast — Svitgrid never sees the data it would need.

Calendar and daily planner

In short

The calendar is where you tell your inverter what to do and when. The planner writes that schedule for you, and asks before it changes anything.

Open the Calendar tab.

The calendar

A week strip at the top, and below it an hour-by-hour timeline of the day. You can lay your battery level, grid flow and export over the timeline, and — in Ukraine — the day-ahead electricity price.

Each coloured block is a scheduled event. Tap it to see what it did and what actually happened.

The daily planner

Rather than building a schedule by hand, let Svitgrid propose one each day. It looks at tomorrow's solar forecast, your tariff, your battery, and any scheduled blackout, and drafts a plan.

You approve it before anything runs. The plan review screen lists each proposed window, why it is there, and the limits it will respect.

Planning styles

StyleAims for
Lower my billCheapest possible electricity cost
Maximum sellingMost revenue from exporting
Survive outagesBattery as full as possible before a scheduled blackout
Use solar at homeLeast import, even if selling would pay more
SmartA balance, adapting to the day
CustomYou set the priorities

Authorising the planner

Because the planner writes to your inverter, it needs explicit permission. You will be asked once to authorise daily planning, which creates a signing key on your device. Without it, the planner can suggest but never act.

Authorisation expires. If plans stop being applied, check the calendar screen for a prompt asking you to re-authorise.

Planner activity

A log of every decision the planner made and every command it sent — useful for understanding why your battery did something unexpected.

Creating a calendar event

In short

An event is a rule: between these hours, on these days, make the inverter behave this way.

Tap + on the Calendar tab.

Choose what the event does

ModeWhat happens
Charge batteryFills the battery, from solar, the grid, or both
Sell to gridExports surplus power
Lower consumptionReduces what the house draws
Use solar at homePrefers self-consumption over export
Use batteryDraws from the battery rather than the grid
Hold batteryStops the battery being used at all
Start generatorRuns a generator on the gen port
Battery maintenance chargeA deliberate full charge to keep cells balanced
Day planningHands the window to the planner
ProfessionalYour own conditions and actions

Set the time window

Start and end time, then how it repeats — once, daily, weekly on chosen days, or a custom pattern. You can also give it a start and end date.

Set the details

Each mode has its own options. The common ones:

  • Charge battery — where the power comes from (solar / surplus / grid / both), the target charge level, and a maximum charging power. There is also a switch to suspend your inverter's own time-of-use schedule while the event runs, so the two do not fight.
  • Sell to grid — a minimum battery level to protect, a maximum export power, and in Ukraine a minimum price below which it will not sell.
  • Start generator — the charge level that starts it, the level that stops it, quiet hours, minimum run and rest times, and whether it should only run when the grid is actually down.
  • Professional — up to eight conditions and eight actions. Conditions can test battery level, solar power, house load, whether the grid is up, whether a blackout is scheduled, the day's forecast, or the market price.

What happens when it runs

At the start time, Svitgrid sends the commands to your inverter and notifies you. At the end, it puts the previous settings back and notifies you again.

An event needs a live collector

If nothing is collecting when the event is due — phone in your pocket, Gateway unplugged — the event cannot run. The calendar will show it as missed.

Every command Svitgrid sends is recorded in Write history, with a timestamp and the value written.

Time-of-use explained

In short

Your inverter has its own built-in daily schedule of up to six time slots. Svitgrid edits that schedule; it does not replace it.

Hybrid inverters have a time-of-use table burned into their own settings — typically six slots covering the whole 24 hours. Each slot says: until this time, aim for this battery level, and may you charge from the grid.

The inverter follows this table by itself, with no phone, no internet and no Svitgrid. That is why it keeps working when everything else fails.

What Svitgrid does with it

When you create a calendar event, Svitgrid translates it into changes to those slots, sends them to the inverter, and puts the old values back afterwards.

Two important consequences

The slots are a partition. They tile the entire day with no gaps. Changing where one slot ends necessarily changes where the next begins.

Editing one slot rewrites the whole table. Svitgrid always writes a complete, valid schedule rather than patching a single row, because a half-written table is a table your inverter will follow incorrectly all night.

Where to see it

Settings → Inverter controls → Time-of-use. You can edit the slots directly if you prefer to manage your own schedule.

If Svitgrid's calendar and your hand-written slots disagree, the calendar wins while an event is running — and restores your slots when it ends. To stop that, either delete the event or turn on "suspend time-of-use during this event".

Blackout schedule

In short

In Ukraine, Svitgrid knows your region's planned outage groups and warns you before the power goes off.

Setting it up

Settings → Household settings:

  1. Region — your oblast.
  2. Group — your queue number, printed on your electricity bill or on your supplier's website.
  3. Advance warning — how long before an outage you want to be told: off, or 1, 2, 3 or 6 hours. The default is 1 hour.

What you see

A strip on the dashboard showing today's and tomorrow's scheduled outages for your group, with a coloured dot for the current state.

What Svitgrid does about it

  • Warns you at the notice period you chose.
  • Tells you if your battery is too low to cover the coming outage.
  • Can fill the battery first, if you create a charge event or use the Survive outages planning style.
  • Can suppress other events during an outage, so a "sell to grid" window does not fight a blackout.

Schedules are published by your regional operator, and they change

Treat the schedule as a good forecast rather than a promise. Emergency outages are not scheduled at all and appear with no warning.

Supported inverters

In short

Svitgrid reads 80 inverter models from 18 brands. It can also control three of those brands — Deye, Sunsynk and Sol-Ark.

There are two different questions, and the answer is not the same:

  • Can Svitgrid read my inverter? For everything in the table below, yes — live power, history, charts, money, forecast, alerts.
  • Can Svitgrid control my inverter? Only Deye, Sunsynk and Sol-Ark. Everything else is read-only.

Read this before you buy

Calendar events, the daily planner, work modes, export limits and time-of-use editing all need control. On a read-only brand, Svitgrid is an excellent monitor and cannot change a single setting. That is a limit of what the manufacturer exposes, not something we can switch on.

All supported brands

BrandModelsTypeControl?What you need
Deye18Hybrid 1/3-phase, split-phase, string, microinverterYesLogger stick serial
Sunsynk5Hybrid 1 and 3-phaseYesLogger stick serial
Sol-Ark4US split-phase hybridYesLogger stick serial
Victron8MultiPlus-II, Quattro-IINoModbus TCP enabled on the GX
Huawei4SUN2000 commercial stringNoSmartLogger3000
Solis (Ginlong)130K 3-phase stringNoLogger stick serial
Solplanet (AISWEI)2ASW100K/110K-LTNoAi-logger
Sofar2HYD 3-phase hybrid (also sold as ZCS Azzurro)NoLogger stick serial
SRNE5Hybrid 12/24/48 V (also sold as Easun ISolar SMX-II)NoLogger stick serial
Anenji1ANJ 4.2 kW 24 VNoSmartESS collector
Megarevo2R…KH3 3-phase, high-voltage batteryNoLogger stick serial
KSTAR3KSE, BluE-S (also sold as Eaton xStorage Hybrid)NoLogger stick serial
Afore16AF…K-TH hybrid, BNT…KTL stringNoLogger stick serial
TSUN2TSOL-MS microinvertersNoLogger stick serial
Swatten1SiH-TH 3-phase, high-voltage batteryNoLogger stick serial
CHINT / CPS1SCE 3.6–6 kW (also sold as Senergy)NoLogger stick serial
INVT1XD 3–6 kWNoLogger stick serial
LuxPower / EG4418kPV, 12kPV, FlexBOSS21, LXP-LB-EU 7KNoAn RS-485 to Wi-Fi gateway

Your inverter may be here under another name

Many of these machines are sold under several brands. Sunsynk and Sol-Ark units are the same hardware as the matching Deye models, so the app lists them as Deye entries — searching Sunsynk or Sol-Ark takes you straight to the right one. The same is true for Easun (SRNE), ZCS Azzurro (Sofar), Eaton xStorage (KSTAR) and Senergy (CHINT).

More detail — which collectors work with which brand

Not every brand works with every collector.

Works with the Svitgrid Gateway (24/7, no phone): Deye, Sunsynk, Sol-Ark, Solis, Sofar, SRNE, Megarevo, KSTAR, Afore, plus Huawei, Victron and Solplanet.

Phone or Home Assistant only: TSUN, Swatten, CHINT, INVT, LuxPower/EG4, Anenji. A Gateway will not collect from these — there is no firmware support for them yet, so it would sit there reading nothing.

Check this before buying a Gateway for one of those six brands.

More detail — brand-specific quirks worth knowing
  • Victron connects on port 502 and needs Settings → Services → Modbus TCP switched on in the GX device. It does not report grid import/export energy, so those totals stay empty.
  • Huawei connects through a SmartLogger3000 on port 502. Close the FusionSolar app while Svitgrid is reading — the logger serves one client at a time.
  • Solplanet uses port 9999, not the usual 8899.
  • LuxPower / EG4 needs an RS-485 to Wi-Fi gateway you buy separately, wired to the inverter's Modbus port. Set the gateway's protocol to Modbus — the factory default of None fails silently: bytes move, nothing decodes.
  • Anenji works the other way round from everything else: the manufacturer's collector dials out to Svitgrid, so there is no IP address to enter. While Svitgrid is collecting, the manufacturer's own app stops receiving data — the collector only talks to one server at a time.
  • SRNE HSI-1500 has no grid power register at all, so grid figures stay blank.
  • Afore BNT string inverters come in two protocol generations that are chosen by serial number prefix, not by the model on the label. If your readings look wrong, try the other entry.
  • Grid current is calculated from power and voltage on every brand — no inverter in this list reports it directly.

How well each model is proven

Support for a model means Svitgrid knows where that inverter keeps its numbers. For the long-standing Deye and Sunsynk models that mapping has been checked against real hardware many times over. For several of the brands added recently it comes from the manufacturer's documentation and has been confirmed on few units — or, in a couple of cases, none yet.

If a reading looks wrong, it may well be wrong — please tell us

A value that is ten times too big or too small, a battery charging when it should be discharging, or a figure that disagrees with the inverter's own screen: send it to hello@svitgrid.app with your model and a screenshot. Nearly every mapping correction we have made started with a message like that, and it usually takes one reading to settle.

Not on the list?

Email hello@svitgrid.app with the make, model and a photo of the label. Adding a brand means mapping its registers, which needs either documentation or access to a real unit.

Connecting to your inverter

In short

Most brands need two things: the inverter's address on your home network, and the serial number of the Wi-Fi stick plugged into it.

What you need

The IP address. Every device on your home network has one, like 192.168.1.50. Svitgrid can usually find it by scanning — try Scan first.

The logger serial. Most inverters talk through a small Wi‑Fi "logger" or "data stick" plugged into their side. It has a serial number, usually 10 digits, and Svitgrid needs it to address the inverter correctly.

Which brands need what

IP addressLogger serial
Deye, Sunsynk, Sol-Ark, Solis, Sofar, SRNE, Megarevo, KSTAR, Afore, TSUN, Swatten, CHINT, INVTYesYes
Victron, Huawei, Solplanet, LuxPower/EG4YesNo
AnenjiNoNo — it dials out to us

Finding the IP address

Easiest — tap Scan in Svitgrid and let it look.

From your router — open your router's admin page and find the connected-devices list. The logger usually appears with a name containing the brand or a long number.

From the logger's own page — many loggers publish a small web page on their own address.

Give the inverter a fixed address

Routers hand out addresses on a lease and can change them. In your router settings, reserve the current address for the logger's MAC address. Otherwise the connection breaks every few weeks for no visible reason.

Finding the logger serial

It is printed on the logger's own label — the small box plugged into the inverter, not the inverter's main nameplate. It is also usually shown in the manufacturer's own app.

Testing the connection

Svitgrid tests as soon as you enter the details. If it fails, it tells you which part failed rather than just "error":

  • Could not connect — wrong IP address, or the inverter is on a different network from your phone.
  • Connected but no answer — usually the wrong logger serial.
  • Answered with nonsense — usually the wrong model selected.

See Troubleshooting.

Requirements

  • The collector and the inverter must be on the same network. Guest Wi‑Fi is a different network. So is a 2.4 GHz network isolated from the 5 GHz one on some routers.
  • The manufacturer's app may need to be closed — many loggers accept only one connection at a time.

Inverter settings and controls

In short

Two screens: one describes your hardware to Svitgrid, the other sends commands to the inverter.

Both are under Settings, and both need owner or admin rights.

Inverter settings — describing your system

This is where you tell Svitgrid what you own. Getting it right matters, because the forecast, the money and the battery warnings are all built on it.

  • Model, IP address, logger serial, phases
  • Battery — chemistry, capacity, cells in series, and whether this inverter shares a battery bank with another
  • Solar — strings, kWp, tilt, azimuth
  • Generator port and smart load
  • Power calibration — a correction factor, if your inverter reports a value at the wrong scale
  • Daily write limit — a cap on how many commands per day Svitgrid may send
  • Transfer collection to another phone — see Moving collection

Inverter controls — changing the inverter

Deye, Sunsynk and Sol-Ark only

On every other brand this screen is read-only, because the manufacturer does not expose writable settings. See Supported inverters.

ControlWhat it does
Energy priorityWhether solar serves the house, the battery or the grid first
Work modeThe inverter's overall operating mode
Grid charge currentHow hard the battery may charge from the grid
Grid peak shavingCaps how much you draw from the grid
Generator forceStarts a generator on the gen port
Battery protectionMinimum reserve, and an extra buffer held back for a scheduled blackout
Battery maintenanceA periodic full charge to keep cells balanced
Time-of-use tableThe inverter's own daily schedule — see Time-of-use
Maximum sell powerHow much you may export

The nameplate is a marker, not a wall

On maximum sell power, your inverter's rated output is drawn on the slider as a reference — you can set a value above it. Many installations are deliberately limited below the rating by a grid agreement, and a few can legitimately exceed it.

Every command is real

These write to your actual inverter. Svitgrid records every write in Write history, and asks for confirmation before anything destructive — but it cannot undo a setting your equipment has already applied.

Adding another inverter

In short

A home can have several inverters. Add each one separately, then tell Svitgrid if they share a battery.

Settings → Add inverter, then the same steps as the first one: model, connection, battery, panels.

Because the household already exists, you are not asked about location or collector again.

Parallel systems

If your inverters are wired in parallel, you will also be asked about topology — which is the master and which are slaves.

Shared battery banks

If two inverters are connected to one physical battery, say so in each inverter's settings. Otherwise Svitgrid counts the same battery twice and reports double your real capacity.

How many are allowed

Your plan sets a limit — see Plans and subscription.

Smart load and generator port

In short

Many hybrid inverters have a second output for a generator or a controllable load. Svitgrid shows what flows through it — once you tell it the port is in use.

What the port is

A spare AC terminal on the inverter, used in one of two ways:

  • Generator input — a petrol or diesel generator feeds the inverter.
  • Smart load output — a load the inverter can switch on when there is surplus power, typically a water heater.

Turning it on in Svitgrid

Settings → Inverter settings → Generator port. Choose which way you use it and switch on Show generator port.

This is the single most common "my numbers are wrong" cause

Until you switch it on, power flowing through that port is subtracted from your house consumption but shown nowhere. The result is that Svitgrid reads lower than your inverter's own screen — on one real installation, 37% lower.

If Svitgrid and your inverter disagree about house consumption, check this setting first.

What you see once it is on

A generator-port node on the dashboard diagram, a detail card with runtime and fuel figures, and its own series in the charts.

Controlling it

On Deye, Sunsynk and Sol-Ark you can force the generator to start from Inverter controls, or schedule it with a Start generator calendar event — including start and stop charge levels, quiet hours, and a rule that it only runs when the grid is actually down.

Svitgrid Gateway

In short

A small box that sits next to your inverter and collects data around the clock, so you do not need to leave a phone at home.

Sold as the Svitgrid Gateway, 999 ₴. The compliance label on the underside calls it ED-1 — same device.

Why you would want one

Your phone can only read the inverter while you are home with the app open. The Gateway never stops. It also does things a phone cannot:

  • Collects 24/7, including overnight and while you are away
  • Runs your scheduled events even when nobody is home
  • Talks to Zigbee smart sockets and EV chargers
  • Reads a battery BMS continuously

Setting one up

  1. Plug it in near the inverter, within reach of your Wi‑Fi.
  2. In Svitgrid, go to Settings → Edge devices → Add device.
  3. Svitgrid finds it over Bluetooth.
  4. Give it your Wi‑Fi name and password.
  5. It connects and starts collecting.

The label has a QR code

Scanning it with your phone camera opens setup for that exact device. It contains no secrets — it is a shortcut, not a key.

The status light

One light, two meanings — there are no blink codes

Solid on — a reading reached the Svitgrid cloud in the last 12 minutes. Everything works.

Off — nothing has been confirmed delivered for 12 minutes, or nothing since it was switched on.

That is the whole vocabulary. Silence is the failure signal; the device never signals "unhealthy" in any other way. On some early hand-built units the light is not connected at all and never comes on.

The button

Do not use hold-the-button gestures you may read elsewhere

On production hardware the case button is wired directly to the chips' reset lines. It is a hardware reset — the firmware cannot detect it being held, so timed presses do nothing. Pairing, factory reset and removal are all done from the app.

Managing it

Settings → Edge devices, then tap the device:

  • Uptime, firmware version and signal strength
  • Pause / resume monitoring
  • Reboot
  • Factory reset
  • Replace with a new unit, keeping your history
  • Remove

Pausing is not the same as switching off

A paused Gateway stays online, keeps its Wi‑Fi and still answers Svitgrid — it simply uploads nothing. It looks exactly like a broken device. See Troubleshooting, which covers this first because it is the most common false alarm.

It beeps

The Gateway plays a short melody each time it successfully applies a battery-charge command from the cloud. On a busy schedule this can be many times an hour.

There is currently no way to switch the sound off. If it bothers you, reduce how often your calendar events change the battery-charge setting.

Installing Gateway firmware

In short

If you built your own hardware or need to recover a device, you can install firmware from your browser at svitgrid.app/flash.

Most people never need this. A Gateway bought from Svitgrid arrives ready to use and updates itself.

What you need

  • A Chromium-based browser — Chrome, Edge or Opera. Safari and Firefox cannot talk to USB devices.
  • A data USB-C cable. Many charging cables have no data wires and will simply not show the device.
  • A direct USB port, not a hub.

Steps

  1. Plug the device into your computer.
  2. Open svitgrid.app/flash.
  3. Click the button and pick your device from the list.
  4. Wait about 30 seconds without unplugging.

Nothing appears in the device list?

Try a different cable first — that is the usual cause. If it still does not appear, open the case, unplug the USB, hold the BOOT button, plug the USB back in, release BOOT, and flash again.

Your device is not damaged

A failed or interrupted flash cannot permanently break a Gateway. You can always try again.

Flashing wipes the Zigbee network

Installing firmware over USB — and a factory reset — erases the Gateway's Zigbee memory. The network is formed again from scratch, so every smart socket you had paired must be paired again. Your inverter data and history are unaffected.

Watching what it does

svitgrid.app/logs shows the device's live output over USB in the same browser. Useful for seeing whether it is joining Wi‑Fi, and worth having open if you contact support.

Firmware updates

In short

The Gateway updates itself over Wi-Fi. You can also trigger an update, or roll back, from the app.

Automatic updates

A new Gateway updates itself to the current firmware during setup, showing progress on your dashboard. After that it keeps itself current.

Updating by hand

Settings → Edge devices → your device → Firmware. You see the installed version, the newest available, and an Update button.

The update runs in stages — download, verify, install, restart — and the app shows which stage it is on. It takes a few minutes. The device keeps collecting until the final restart.

Rolling back

The Gateway keeps the previous firmware in a second slot, so Roll back returns to it. Only one version back is kept.

Safe by design

The new firmware is checksum-verified before installation. If an update is interrupted or the new version fails to start, the device automatically returns to the version that was working.

Home Assistant

In short

If you already run Home Assistant, it can be your collector — and it can control your inverter too.

This is a custom integration, not an add-on

Look for it under Settings → Devices & services, not under Add-ons. Older documentation and some community posts call it an add-on; that name is wrong and sends you to the wrong menu.

Installing it

  1. In HACS, add https://github.com/svitgrid/home-assistant-svitgrid as a custom repository of type Integration.
  2. Install Svitgrid from HACS.
  3. Restart Home Assistant.
  4. Go to Settings → Devices & services → Add integration and choose Svitgrid.
  5. Follow the prompts to link it to your Svitgrid account.

Do not copy files by hand

Copying the folder into custom_components works once and then never updates itself. Installing through HACS is what keeps it current.

Keeping it updated

The integration checks for a new version every 12 hours and installs it. It never restarts in the middle of sending a command. You can switch this off under Configure → Settings.

If Svitgrid shows an "integration out of date" banner, your version is below the minimum we support — update it through HACS.

What it can do

  • Read your inverter through the sensors you already have in Home Assistant, or by talking Modbus to it directly.
  • Control your inverter: battery charge, work mode, solar sell, grid charge, generator force, generator port mode and export limit.
  • Store data locally, in its own database, keeping about two weeks of detail and roughly two years of hourly history.
  • Run your schedule locally, so events fire even with no internet.

Control works, despite what older documentation says

Earlier versions of these docs said Home Assistant was read-only. That has not been true for some time — seven control commands are supported.

Which inverters it works with

The integration ships ready-made mappings for dozens of models — Deye, Victron, Anenji/EASUN, Huawei, Solplanet, Solis and more, refreshed automatically from Svitgrid. If your model is not covered, you can map the entities yourself from the integration's options.

What it cannot do

  • No Zigbee sockets or EV chargers. Those need a Svitgrid Gateway.
  • No battery BMS reading. Home Assistant has no radio that Svitgrid drives; use a Gateway or your phone.

Local mode

In short

Home Assistant can run Svitgrid entirely on your home network, with no internet at all. You choose separately whether to also send data to the cloud.

Also called island mode. Two independent switches, and confusing them causes most of the surprises.

SwitchWhat it controls
Connection modeWhether your app reads from your home network directly, or from the Svitgrid cloud
Send data to Svitgrid cloudWhether readings are uploaded at all

Why you would use it

  • Your internet is unreliable, and you want the dashboard to keep working anyway.
  • Your schedule must run during an outage that takes your router down with it.
  • You would rather your energy data did not leave the house.

Turning it on

Settings → Home Assistant → Connection mode. Available on Plus and above.

What you lose with cloud sync off

This is the trap

With cloud sync off, Svitgrid never receives your data. That means:

  • No data when you are away from home. Your phone cannot reach your house, so the dashboard is empty on mobile data.
  • No solar forecast. It is computed in the cloud from your history.
  • No daily planner.
  • No notifications. They are sent by the cloud, which no longer knows anything.

If you want local reliability and remote access, leave local mode on and cloud sync on. That combination gives you both.

When the box cannot be reached

If your phone is on local mode but cannot reach Home Assistant — you have left the house, or the box is down — Svitgrid falls back to the cloud automatically, provided cloud sync is on.

Smart devices

In short

With a Gateway you can add Zigbee smart sockets and EV chargers, then switch them from Svitgrid or from a schedule.

Settings → Smart devices.

What you can connect

  • Smart sockets — Zigbee sockets, for a water heater, a pump, or anything you want switched on surplus solar.
  • EV chargers — charge the car when the sun is out or the price is low.

Zigbee sockets need a Svitgrid Gateway

The Gateway contains the Zigbee radio. Without one, the socket rows are greyed out. EV chargers work on the phone-collector path too.

Adding a socket

  1. Open Settings → Smart devices.
  2. Tap the add action in the top bar.
  3. Put the socket into pairing mode — usually by holding its button until it flashes.
  4. Svitgrid keeps a 2-minute pairing window open and shows the device when it joins.

What you can do with them

  • Switch on and off by hand
  • See what each one is consuming, and its history
  • Include them in a calendar event — turn the heater on when the battery is above 80%, off when a blackout is scheduled
  • Pick which ones an alert's "turn these off" suggestion actually switches

Mesh view

Zigbee devices relay for each other. The Mesh screen shows which are connected directly, which route through a repeater, and which are unreachable, with a Test connection button.

A socket that keeps dropping out is usually too far away

Add a mains-powered Zigbee device between it and the Gateway; it will relay automatically.

Battery monitors

In short

If your battery has a BMS Svitgrid can read, you get every individual cell's voltage instead of one number for the whole pack.

Your inverter reports a single state of charge. A battery management system inside the pack knows far more: each cell's voltage, temperatures, how balanced they are, how many cycles the pack has done.

Supported monitors

MonitorNotes
JK BMSTwo protocol variants, up to 24 or 32 cells
JBD / XiaoxiangAdvertises as xiaoxiang
ANT BMS2021 protocol

JK monitors need you to pick

The two JK variants look identical over Bluetooth and cannot be told apart automatically. Pick one; if the readings look wrong, switch to the other.

How it is read

CollectorHowWhen
Svitgrid GatewayThe Gateway's own BluetoothEvery 5 minutes, always
Your phoneThe phone's BluetoothEvery 5 minutes, while the battery screen is open
Home AssistantNot supported

It shares nicely

The Gateway connects, reads, and disconnects each cycle, so your manufacturer's own app can still connect between reads.

Adding one

Battery → Monitors → Scan. Svitgrid lists the battery monitors it can see, with signal strength. Choose yours and adopt it.

Adopt only your own battery

Bluetooth reaches through walls, so a neighbour's battery can appear in the list. Svitgrid marks a weak signal as "may not be yours". Adoption is deliberate for exactly this reason.

You can have up to 8 packs. Give each a name that says where it physically is.

What you get

Per-cell voltages, the spread between best and worst cell, temperatures, charge and discharge switch states, balancer activity, state of health, lifetime throughput and cycle count — plus a plain-language verdict at the top of the screen.

Pausing and diagnostics

Each monitor can be paused if you need the vendor app to have exclusive access. There is also a raw-frame toggle for support to diagnose an unrecognised monitor.

Known issue — a pack counted twice

If you have both a Gateway and an iPhone reading the same physical battery, it can be stored twice under two identities, doubling your reported capacity. Both rows look internally consistent, so it is easy to miss. If your pack count looks too high, pause reading on one of the two collectors. Android is not affected.

Moving collection to another phone

In short

If your phone is the collector, you can hand that job to a different phone by scanning a code.

Useful when you replace your phone, or want an old one left at home as a dedicated collector.

How to do it

  1. On the old phone: Settings → Inverter settings → Transfer collection. It shows a QR code.
  2. On the new phone: sign in to the same account, open the household, and scan the code.
  3. Collection moves across.

The code is short-lived. If it expires, generate a new one.

What changes

The new phone becomes responsible for reading the inverter. The old one keeps full access to the app — it simply stops collecting. Your history is untouched.

A spare phone makes a decent collector

Leave it plugged in, on the home Wi‑Fi, with Svitgrid open and the screen allowed to stay awake. It is not as reliable as a Gateway — phones sleep, updates restart them — but it is far better than nothing.

Your devices and signing keys

In short

Every phone that can change your inverter carries a key. This screen lists them and lets you revoke any you no longer trust.

Settings → Your devices.

Because a command to your inverter is a real physical action, Svitgrid signs each one with a key held on the device that sent it. A phone with no key can view everything and change nothing.

Approving a new phone

When you sign in on a new device and first try to change something, Svitgrid asks you to approve that device. Confirm from a phone that is already trusted.

If your only approved phone is lost

You are not locked out

If the approved device is gone — lost, broken or sold — and it was the only one, Svitgrid emails a 6-digit code to your account address. Type it into the new phone and it becomes the approved device.

Then open this screen and revoke the old one, so a found or resold phone cannot send commands to your inverter.

Recovery clears the other trusted keys on the account, so any remaining phones must be approved again.

Device detail

Each entry shows the device name, when it was approved, and when it was last used to send a command.

Revoking

Revoke removes a device's key. It can still view your data; it can no longer change anything. Do this immediately for a lost or sold phone.

Reset all signing

Revokes every key at once, including the one on the phone you are holding. Everything must be approved again from scratch. Use it if you think a key has been compromised.

Write history

In short

A complete log of every setting Svitgrid has changed on your inverter — what, when, by whom, and whether it worked.

Settings → Inverter settings → Write history.

Each entry shows the time, the setting, the value written, what triggered it — you, a calendar event, or the planner — and whether the inverter confirmed it.

When it is useful

  • "Why did my battery drain overnight?" Find the event that changed a setting and see the value.
  • "Did my schedule actually run?" A missing entry means it never fired.
  • "Who changed this?" Every entry names the person or the automation.

Before contacting support about strange behaviour, open this screen and look at the hours around the problem. It usually contains the answer.

Register dump

In short

A diagnostic tool that reads raw values straight out of your inverter. Mostly used when helping support add or fix a model.

Settings → Inverter settings → Register dump.

Inverters expose their data as numbered "registers". This screen reads them directly, without Svitgrid's interpretation.

Two modes: read a specific range you are asked for, or scan a wider span to discover what a model exposes.

You will rarely need this

It exists so that when support asks "what does register 169 read while you are exporting?", you can answer. If your model is new or its readings look wrong, this is how it gets fixed.

Reading is safe; interpreting is not

Nothing here changes a setting. But a raw number means nothing without knowing the model's scale — a value of 2400 might be 2400 W, 240.0 V, or 24.00 A. Do not build conclusions on a register you have not confirmed with support.

Profile and security

In short

Your name, your email, your password, and the switch that adds a second step at sign-in.

Settings → Account.

Edit your profile

Name, email address and photo. Changing your email requires confirming the new address.

Change your password

Under Security. You need your current password.

Two-factor authentication

Also under Security. Once on, signing in needs a code from your authenticator app as well as your password.

Keep your recovery codes

Save them somewhere that is not your phone. If you lose your authenticator and your codes, nobody can restore access for you.

Delete your account

At the bottom of the Account screen, in the danger zone.

What happens to each of your homes depends on whether anyone else is in it:

  • Homes where you are the only member are detached, exactly as described under Household settings — unreachable, anonymised, hardware access revoked.
  • Homes shared with other people carry on without you. Ownership passes automatically to whoever has been a member the longest, and they keep the history, the equipment and the settings.

Households you were only invited to are unaffected — you are simply removed from them.

Handing a home over deliberately

If you want a specific person to take over rather than the longest-standing member, make them a member first and transfer ownership to them before deleting your account.

There is no undo

Neither your account nor your homes can be restored afterwards. If you only want to stop paying, cancel the subscription in the App Store or Google Play instead — your data stays where it is.

Household settings

In short

Name, photo, location, blackout region, and the battery reserve Svitgrid protects for you.

Settings → Household settings. Owner or admin only.

What you can change

  • Name and picture — how the home appears in your list.
  • Location and country — drives the solar forecast, and decides whether Ukrainian tariff and blackout features appear at all.
  • Blackout region and group — see Blackout schedule.
  • Advance warning — off, or 1, 2, 3 or 6 hours before a scheduled outage. The default is 1 hour.
  • Diagnostic code — a short code identifying this home. Quote it when you report a problem and support can find your system immediately.
  • Battery reserve — the charge level Svitgrid will not plan below.
  • Outage buffer — extra charge held back specifically to cover a scheduled blackout, up to 6 hours' worth.

Several homes

Settings → Households → Create household adds another. Each has its own inverters, tariff, members and history. Switch between them from the same menu.

How many you may own depends on your plan — see Plans and subscription.

Renaming and removing

Rename freely.

Deleting is different from what most people expect, so it is worth being precise. Svitgrid shows you a count of what will be detached before you confirm, and then:

  • The home disappears from your account and from every member's account. Nobody can reach it again.
  • Its name and identifying details are anonymised.
  • Any Svitgrid Gateway attached to it has its access revoked, so it stops collecting. Where the app can, it also tells the device to wipe itself.
  • The readings themselves are kept, detached and belonging to nobody.

You cannot undo it, and you cannot get the home back

"Detached, not destroyed" does not mean recoverable. There is no restore button. Treat deletion as permanent.

Sharing with family

In short

Invite other people into your home. They see your data on their own account, at the level of access you choose.

Settings → Members. Owner or admin only.

Inviting someone

Tap Invite, enter their email address, and choose their role.

Svitgrid does not email the invitation — you have to tell them

No message is sent. The invitation waits inside the app until the person signs in to Svitgrid using that same email address, and it then appears under Settings → Pending invitations for them to accept.

So two things have to be true, and both are on you to arrange:

  1. They install Svitgrid and create an account with exactly the email you invited. A different address, or signing in with Google when you invited a plain email, will not find the invitation.
  2. You tell them to look, because nothing notifies them.

Pending invitations are listed on your Members screen until accepted, and you can cancel one at any time. An invitation expires after 7 days — if it lapses, just send another.

Roles

RoleCan viewCan change settings and control the inverterCan invite and remove peopleCan delete the household
OwnerYesYesYesYes
AdminYesYesYesNo
MemberYesNoNoNo

There is exactly one owner, and the role cannot be changed or removed. To hand a home to somebody else, transfer ownership.

Choose Member for most people

A family member who wants to see how much solar the house made does not need permission to rewrite the inverter's schedule. Member is the right default.

Changing or removing

Tap a person to change their role or remove them. An admin cannot remove another admin, and nobody can remove the owner.

Who pays

Invited members ride on the owner's plan. They are never asked to subscribe, and their access is whatever the owner's plan allows.

Electricity tariff

In short

Tell Svitgrid what you pay and what you are paid, and every chart gains a money column.

Settings → Electricity tariff. Ukrainian households only — the screen is hidden elsewhere, because these are Ukrainian tariff structures.

Choose your pricing model

ModelFor whom
FixedStandard household tariff. You cannot sell.
Green tariffYou have a green tariff contract and are paid for export.
Day-ahead market (РДН)You buy and sell at the hourly market price.
Active consumerYou buy at market price and sell capped at the household rate.
CooperativeAn energy cooperative sets your hourly prices.
BusinessA single flat commercial rate, around the clock.

Meter type

  • Single zone — one price all day, 4.32 ₴/kWh.
  • Two zone — day 4.32, night 2.16, night running 23:00–07:00.
  • Three zone — peak 6.48 (08:00–10:00 and 20:00–21:00), semi-peak 4.32, night 1.73 (23:00–07:00).

Electric heating

If your home is registered for electric heating, switch it on. During the heating season, 1 October to 30 April, the first 2000 kWh each calendar month is charged at 2.64 ₴/kWh, and consumption above that at the standard rate.

More detail — how green tariff settlement is calculated

This is the part people most often expect to work differently, so here it is exactly.

  • You qualify only as a private individual on a universal supply contract. Business entities do not qualify.
  • Export between 23:00 and 04:00 is excluded entirely — those hours earn nothing. Note this is a narrower window than the two-zone "night".
  • Export in any hour above your installed generation capacity is trimmed to that capacity.
  • Payment is on the monthly balance: eligible export minus import. If you imported more than you exported, the result is zero, not a negative bill.
  • If you imported nothing at all in the month, no green tariff payment arises.
  • Tax is withheld: 18% income tax plus 5% military levy. You receive 77% of the gross figure. Svitgrid shows you the net amount, because that is what reaches your account.

The rate itself depends on the year your system was commissioned, and is set by national regulation. Svitgrid holds the current table and applies the right rate for your commissioning year.

Seeing the effect

Once set, the dashboard's grid card prices today's import and export, the battery card shows what charging from the grid cost, and the Finance tab in Reports shows the month.

Day-ahead market (РДН)

In short

In Ukraine, electricity has a different price every hour, published a day ahead. Svitgrid shows those prices and can schedule around them.

Where the prices come from

Svitgrid fetches the official day-ahead prices for Ukraine every hour and stores them by date and hour. Tomorrow's prices appear once the market publishes them, usually in the afternoon.

Seeing them

Turn on the price overlay on the Calendar timeline. Expensive hours and cheap hours become obvious at a glance.

Using them

With the Day-ahead market or Active consumer tariff selected, you can set:

  • Minimum selling price — do not export below this, default 5.00 ₴/kWh.
  • Maximum charging price — do not charge from the grid above this, default 3.00 ₴/kWh.
  • Maximum battery cycles per day — stops arbitrage wearing the battery out, 0 to 4.

A Sell to grid or Charge battery calendar event can then take the price into account, and the daily planner will place windows in the cheapest and dearest hours by itself.

Buying at market price needs registration

Without УЗЕ registration you pay the standard household rate no matter what the market does, so the buy-side thresholds will not save you anything. Selling is unaffected.

Plans and subscription

In short

Svitgrid is a paid app with a 14-day free trial. There are three plans, plus a permanently free fallback for anyone who bought a Gateway.

The plans

BasicPlusPro
Price per month$1$5$10
Price per year$10$50$100
Homes135
Inverters per home13Unlimited
People you can invite510
Live dashboardYesYesYes
Blackout and fault alertsYesYesYes
Stored history and chartsYesYesYes
Solar forecastYesYes
Calendar automation and daily plannerYesYes
Local (island) modeYesYes
Systems above 50 kWYes
Fastest refresh60 s30 s30 s

Organisation plans, for operators managing many sites, are quoted individually — email hello@svitgrid.app.

Prices are shown in US dollars; the store charges you in your own currency.

The free trial

Every plan starts with a 14-day free trial, handled by the App Store or Google Play. You are not charged until it ends, and cancelling before the end costs nothing. The trial is once per account.

If you own a Gateway

Your hardware never stops working

If you bought a Svitgrid Gateway and your subscription lapses, you do not lose the device. You keep:

  • The live dashboard
  • Manual control of your inverter
  • Six safety alerts — power outage, grid restored, inverter error, low battery, critical battery, and battery heading for empty

You lose stored history, charts, daily totals, the forecast and calendar automation. Your old history is hidden, never deleted — subscribe again and all of it returns.

This applies to the physical Gateway only. A Home Assistant setup does not qualify.

Managing your subscription

Settings → Subscription shows your plan and renewal date. Changing or cancelling is done in the App Store or Google Play, not in Svitgrid — Apple and Google own the billing relationship.

Restore purchases on that screen recovers a subscription after reinstalling or changing phone.

Current rollout status

Nothing is locked yet

Plan limits are not currently being enforced. Everyone has full access to every feature while we finish rolling subscriptions out. When enforcement begins you will get a trial and clear notice first — locked sections will show a preview and a button rather than an error.

Appearance and language

In short

Light or dark, and 11 languages.

Settings → App settings.

Theme

Light, Dark, or System to follow your phone.

Language

Svitgrid is available in: English, Українська, Español, Português, Deutsch, Türkçe, Nederlands, Polski, Français, Italiano and العربية.

It follows your phone's language by default. Changing it here applies immediately and syncs to your account, so notifications arrive in the same language.

These docs are available in all 11 languages too

Use the language menu in the top bar.

Data quality

In short

Every chart, total and forecast is only as good as the hours your collector was actually running. This page explains how to tell whether yours has gaps.

The problem with collecting on a phone

A phone is not a server. It sleeps, it leaves the house, its battery runs down, the operating system closes background apps to save power. A phone collector typically covers 2 to 4 hours a day.

That does not merely lose those hours — it distorts what is built on them:

  • Daily totals read low. Energy that flowed while nothing was watching is not counted.
  • Charts have holes. Svitgrid draws a gap rather than inventing a line, so you can see it.
  • The forecast learns from an incomplete picture and takes longer to become accurate.
  • Scheduled events do not run. If nothing is at home at 02:00, nothing tells the inverter to charge.
  • Alerts do not fire. "Inverter offline" cannot be detected by a collector that is itself offline.

Your options, best first

1. A Svitgrid Gateway. 999 ₴, collects 24/7, runs your schedule, reaches Zigbee devices and battery monitors. This is the option with no gaps.

2. Home Assistant. Free if you already run it, collects 24/7, can control the inverter and run schedules locally.

3. A dedicated phone left at home. Free if you have an old phone. Plug it in, join the home Wi‑Fi, open Svitgrid, allow the screen to stay awake, and disable battery optimisation for the app. Better than nothing, worse than either option above — phones still restart for updates and drop off Wi‑Fi.

4. Your everyday phone. Fine for trying Svitgrid out. Not a monitoring solution.

Checking your own data

Open Charts → Overview and look at the production heatmap. Collected hours and genuinely-zero hours are drawn differently, so gaps are visible as gaps.

The dashboard also has a Data collection health card on phone-collector households, which states plainly how much of the last day was actually covered.

Your data

In short

What Svitgrid stores, how long it keeps it, and how to get rid of it.

What is stored

  • Your account — email, name, optional photo.
  • Your household — name, location, tariff, equipment description.
  • Readings — power, energy, battery, voltages, temperatures from your inverter.
  • Commands — every setting Svitgrid changed, and who triggered it.

Svitgrid does not collect the contents of your home network, and does not read anything on your phone beyond what the app itself stores.

How long it is kept

WhatKept
The live readingCurrent only, overwritten
5-minute detail7 days
Hourly detail90 days
Daily, weekly, monthly totalsIndefinitely
Command history90 days

This is why a chart of last week has minute-level shape and a chart of two years ago has one point per day.

Where it is

On Google Cloud, in Europe. Traffic between your collector, the cloud and your phone is encrypted.

Local mode

With Home Assistant in local mode and cloud sync off, readings stay on your own hardware and never reach Svitgrid at all. See Local mode for what you give up.

Deleting it

Settings → Account → Delete account closes your account and detaches every household you own. The homes become unreachable to everyone, their identifying details are anonymised, and attached hardware loses its access. The stored readings are retained in anonymised form rather than erased row by row.

It cannot be undone, and nothing can be restored afterwards. If you want the readings themselves erased as well, email hello@svitgrid.app from your account address and say so.

Full terms: Privacy policy · Terms of service

Words explained

In short

Every piece of jargon in the app and on this site, in plain language.

kW (kilowatt) — a rate, like the speed on a car's dial. How fast power is flowing right now.

kWh (kilowatt-hour) — an amount, like the distance travelled. 2 kW flowing for 3 hours is 6 kWh. Your bill is in kWh.

Inverter — the box that turns the panels' DC into the AC your house uses, and manages the battery.

Hybrid inverter — an inverter that handles solar, battery and grid together.

String — one chain of solar panels wired in series. Most homes have one or two.

kWp — the maximum power your panels could make in perfect conditions. Used to size the forecast.

Azimuth — which compass direction the panels face. South is 180°.

Tilt — the angle of the panels from flat. A typical pitched roof is around 30°.

SOC (state of charge) — how full the battery is, as a percentage.

Depth of discharge — how far down the battery is allowed to go before the inverter stops using it.

Export / feed-in — sending surplus power to the grid.

Import — taking power from the grid.

Curtailment — panels producing less than they could, because the battery is full and there is nowhere for the power to go.

Green tariff (зелений тариф) — a Ukrainian scheme paying households for exported solar.

Day-ahead market (РДН) — the Ukrainian hourly wholesale electricity market.

УЗЕ — the registration that lets a household buy at market prices.

Time-of-use (TOU) — the inverter's own built-in daily schedule of battery targets.

Work mode — the inverter's overall strategy: serve the house first, charge the battery first, or export.

Gen port — a second AC terminal for a generator or a switchable load.

Smart load — a load the inverter switches on when there is surplus power.

BMS (battery management system) — the electronics inside a battery pack that measure and protect each cell.

Collector / harvester — whatever reads your inverter and sends the data on: a phone, a Gateway, or Home Assistant.

Logger stick — the small Wi‑Fi module plugged into the inverter, through which most brands are read.

Modbus — the industrial protocol inverters speak.

Register — one numbered value inside the inverter, like a numbered pigeonhole.

Zigbee — the low-power radio used by smart sockets.

Island mode / local mode — running entirely on your home network with no internet.

MPPT — the part of the inverter that squeezes the most power out of a panel string. One MPPT usually means one string it can optimise independently.

CT clamp — a ring sensor clipped around your incoming mains cable so the inverter can measure what the whole house is drawing.

OTA — an update delivered "over the air", by Wi‑Fi, rather than by cable.

HACS — the community add-on store for Home Assistant, and how the Svitgrid integration is installed.

DHCP — how your router hands out addresses. It is why an inverter's address can change on its own.

AP isolation / guest network — a router setting that stops devices seeing each other. It will block your collector from reaching the inverter.

TOTP — the 6-digit code from an authenticator app, used for two-factor sign-in.

L1, L2, L3 — the three phases of a three-phase supply.

ФОП / legal entity — a registered business. Business entities do not qualify for the household green tariff.

Universal vs market supply — your contract type with your electricity supplier. The green tariff requires universal supply.

Commissioning year — the year your solar system was formally connected. It fixes which green tariff rate you are paid for its lifetime.

Troubleshooting

In short

The things that actually go wrong, in the order they are worth checking.

"Device is offline" or "no data since…"

Check this first — it is the most common false alarm

Is monitoring paused? Open Settings → Edge devices → your device. A paused Gateway keeps its Wi‑Fi, stays online and answers everything — it just uploads nothing, which looks exactly like a fault.

Two things that make this worse:

  • Rebooting does not clear a pause. The setting survives a restart, so a reboot looks like a failed fix and sends you hunting a fault that is not there.
  • "Refresh now" does nothing while paused, because the pause is precisely what suppresses the upload.

Only Resume clears it.

If it is not paused:

  1. Is the device powered? Check the status light — solid means data reached the cloud in the last 12 minutes.
  2. Is your Wi‑Fi up? The Gateway needs the same network it was set up on. A changed Wi‑Fi password stops it silently.
  3. Has the inverter's IP address changed? Routers reassign addresses. Reserve a fixed one.
  4. Power-cycle the Gateway only after the above — it is rarely the answer.

Cannot connect to the inverter

Let the app diagnose it first

Svitgrid has a built-in connection troubleshooter — open the inverter and choose Troubleshoot connection. It names the actual failure (could not connect, no answer, unreadable answer) and offers Retry, Edit IP, Scan or Contact support. That is faster and more reliable than testing by hand.

  1. Same network? The collector and inverter must be on the same Wi‑Fi. Guest networks are separate networks.
  2. Correct IP address? Use Scan rather than typing it.
  3. Correct logger serial? It is on the logger's label, not the inverter's nameplate.
  4. Another app connected? Most loggers accept one connection at a time. Close the manufacturer's app.
  5. Correct model? The wrong model connects successfully and returns nonsense.

The numbers are lower than my inverter's own screen

Almost always the generator port. If your inverter has a smart load or generator connected and you have not told Svitgrid, that power is subtracted from house consumption and displayed nowhere. See Smart load and generator port.

Charts have gaps

Your collector was not running. This is not a fault — see Data quality.

Everything reads zero

  • Check the inverter is actually on.
  • Check the correct model is selected — a wrong model can decode real data into zeros.
  • At night, zero solar is correct.

The forecast is wrong

  1. Check kWp, azimuth and tilt in Inverter settings → Solar configuration.
  2. Give it two weeks to learn your roof.
  3. Remember it forecasts potential. If your battery filled and the system curtailed, actual output is legitimately below forecast.

A scheduled event did not run

  1. Was anything collecting at the time? No collector, no event.
  2. Is your inverter controllable? Only Deye, Sunsynk and Sol-Ark can be controlled.
  3. Is the planner still authorised? Authorisation expires.
  4. Check Write history — it shows whether a command was sent and what the inverter said.

The Gateway keeps beeping

It plays a melody each time it applies a battery-charge command. There is currently no way to mute it; reduce how often your schedule changes that setting.

Smart socket keeps dropping off

Too far from the Gateway. Add a mains-powered Zigbee device in between to act as a relay, and check the Mesh screen.

The app is slow or crashes

Update to the latest version, restart the app, and if it persists, reinstall — your data is in the cloud and nothing is lost.

Still stuck

Email hello@svitgrid.app with your inverter model, what you see, and roughly when it started. A screenshot and a look at Write history will usually get you an answer in one reply.

Frequently asked questions

In short

Short answers to the questions we are asked most.

Is Svitgrid free?

No. Svitgrid is a paid app with a 14-day free trial, from $1 per month. There is one exception: if you bought a Svitgrid Gateway, you keep a live dashboard, manual control and safety alerts forever, even with no subscription. See Plans and subscription.

Note that plan limits are not currently being enforced — everything is unlocked while we finish the rollout.

Does Svitgrid work without internet?

Only with Home Assistant in local mode. Otherwise readings travel through the Svitgrid cloud, so both your collector and your phone need a connection.

Your inverter does not need Svitgrid. Its own time-of-use schedule keeps running regardless.

Can Svitgrid control my inverter?

Only on Deye, Sunsynk and Sol-Ark. Every other brand is read-only. See Supported inverters.

Can I use several inverters?

Yes. Add each one, and tell Svitgrid if they share a battery bank. How many depends on your plan.

Why do you need the logger serial number?

Most inverters are reached through a Wi‑Fi logger stick that acts as a gateway. The serial number is how a request is addressed to the right inverter behind it. Some brands do not need it — see Connecting to your inverter.

Can my family see my data?

Yes — invite them under Members. They ride on your plan and are never charged. Choose the Member role for view-only access.

What is the difference between kW and kWh?

kW is speed; kWh is distance. Your inverter making 3 kW for two hours has produced 6 kWh.

Why is grid power negative?

Negative means exporting — you are sending power to the grid rather than taking it. That is a good sign.

Why is my battery runtime shorter than I expect?

Svitgrid counts down to your inverter's own cut-off, not to 0%. A battery at 50% with a 30% reserve has 20% of usable charge left.

Will you support Growatt, SMA or Fronius?

They are not supported today, and no work is currently under way on them. Email hello@svitgrid.app with your model — demand is how we choose what to add next.

Why did my household disappear?

Almost always a different sign-in method. Signing up with Google and later signing in with email creates two separate accounts. Sign out and try the other method.

What is Fleet view?

A separate set of screens for operators who look after many sites at once — a map of stations, cross-site alerts, analytics and market arbitrage. It only appears if your account belongs to an organisation. If you look after your own home, you will never see it.

How do I report a problem?

Email hello@svitgrid.app with your model, the symptom, and when it started. Screenshots help.