Help

How GridSentinel works and how to set it up.

After a quick answer instead? See the FAQ for setup, billing, troubleshooting and privacy questions.

01
Getting started
What you need before signing up, the onboarding walkthrough, and disabling SmartShift.
02
How it works
Automation modes, the forecast profiles, battery actions, and the decision history.
03
Your battery
Powerwall, Sigenergy and FoxESS specifics, and how AC-coupled solar fits in.
04
Settings & safety
Reserve floor, Standby, notifications, sign-in methods, manual control.
05
Troubleshooting
Paused reasons, connection issues, negative earnings. In the FAQ.
06
Account, billing & privacy
Deleting your account, subscription, what we retain. In the FAQ.

01 · Getting started

What do I need before signing up?

GridSentinel is a battery automation service for Australian Amber Electric customers. Three things need to be in place before signing up.

1. An active Amber Electric account. GridSentinel reads your live wholesale prices and forecasts through Amber's API. If you're not on Amber, there's nothing for the engine to act on. More about Amber.

2. A supported home battery. See the Your battery section for the current list and what each brand needs.

3. Amber SmartShift disabled. If SmartShift is controlling your battery, it will conflict with GridSentinel. The fix is simple and described below.

GridSentinel onboarding compatibility check
Onboarding starts with a compatibility check.

What happens during onboarding?

Onboarding is a short guided setup. You can stop and resume later: your progress is saved.

  1. Welcome and compatibility check. Pick your battery brand and model so we can confirm it's supported.
  2. Connect Amber. Paste a personal API key from your Amber account.
  3. Connect your battery. Sign in to your battery vendor. A SmartShift warning sits inside this step if needed.
  4. Configure. Pick your automation mode (Basic Rules to start, or Smart Rules / Forecast Optimiser if available on your account), and set your sell threshold, buy threshold and minimum reserve.
  5. Location and demand windows. Your location and demand-tariff windows help the engine plan around your tariff. Some of these steps only appear when the mode you picked needs them.
  6. Passkey. Adds a strong sign-in method to your account. Most phones use Face ID or fingerprint behind the scenes.
  7. Activation. Final review and switch-on. Until you tap activate, the engine sends no commands to your battery.

Where do I get my Amber API key?

Your API key lives on Amber's website (app.amber.com.au), not the Amber mobile app. To create one:

  1. Log in to app.amber.com.au in a web browser.
  2. Go to the Settings tab.
  3. Toggle on Developer mode.
  4. Go to the For Developers tab.
  5. Click Generate a new token.
  6. Give it a name and click Generate.

Your token is shown only once. Copy it somewhere safe before closing the dialog, then paste it into GridSentinel. The key starts with psk_.

How do I disable Amber SmartShift?

Two services on the same battery conflict, so SmartShift needs to be off before GridSentinel takes over. The same path works for Tesla Powerwall, Sigenergy and FoxESS.

  1. Open the Amber app
  2. Go to Settings
  3. Scroll to Amber SmartShift
  4. Tap View
  5. Toggle off SmartShift Automation

Once SmartShift is off, head back to GridSentinel and continue the Connect Battery step.

My battery isn't supported. Can I still join?

Today GridSentinel supports Tesla Powerwall, Sigenergy SigenStor, and FoxESS. Other brands like AlphaESS, Enphase, BYD, Goodwe, Sungrow and Solax aren't supported yet.

Join the waitlist on the homepage and tell us which battery you have. The brand with the most waitlist signups goes next.

02 · How it works

What does GridSentinel actually do?

Every five minutes, GridSentinel reads your current Amber price, looks at the price forecast, checks your battery state, and decides what your battery should do next. It then sends that command to your battery and records the decision so you can see what happened and why.

You don't drive it minute-by-minute. You pick an automation mode (and a profile if you're on Forecast Optimiser), and the engine handles the rest. Every decision shows up in the History tab with a one-line reason.

Dashboard showing the current mode and the reason for it
The dashboard shows the current mode and the reason for it.

What are the automation modes?

Open Settings → Automation to pick how GridSentinel drives your battery. Four choices.

Basic Rules. Simple price rules using your sell threshold, buy threshold and reserve. Default for new accounts. Easy to reason about and a sensible starting point.

Smart Rules. Build readable rules for how GridSentinel responds. For example, "export above 30c unless the battery is below 30%." Rules start once GridSentinel has live battery and price data.

Forecast Optimiser. Plans charge and export ahead using prices, forecasts, solar, household load and battery state. The deepest mode, with a per-account profile you pick.

Standby. No automation. The engine doesn't change your battery. Manual controls still work. Use this when you want to pause without disconnecting.

Currently rolling out: Forecast Optimiser and Smart Rules are being enabled gradually. If an option shows as unavailable in your app, you're on Basic Rules in the meantime.

There's also an Observe only toggle near the bottom of the Automation section. When on, GridSentinel evaluates and logs decisions without actually sending any commands to your battery. Useful for watching what the engine would do before letting it act.

Automation mode picker in Settings
Settings → Automation. Pick a mode, configure it underneath.

What are the Forecast Optimiser profiles?

When you use Forecast Optimiser, you pick one of three profiles. The selector appears in the Automation card in Settings once Forecast Optimiser is the active mode. The profile shapes how aggressive the engine is.

Battery Saver. Protects backup reserve and battery wear. Acts only on stronger opportunities.

Balanced. The default. Balances savings, battery wear and backup reserve.

Maximiser. Pursues more price opportunities and may cycle the battery more often.

You can switch profiles any time. Changes take effect on the next cycle.

Forecast Optimiser profile selector
Three profiles, each tuned to a different priority.

What does each battery action mean?

At each five-minute cycle the engine picks one of four actions.

  • Exporting. Battery discharges to the grid. Triggered when the feed-in price is high enough to make selling worthwhile. Earns revenue on your Amber account.
  • Charging. Battery charges from the grid. Triggered when import prices are low or negative. You're stocking up cheaply to use or sell later.
  • Curtail. The engine blocks grid export. Used when feed-in prices are negative so you don't pay to send energy out. The battery still powers your home; what happens to excess solar depends on your hardware (see the AC-coupled note below).
  • Normal mode. Default operation. Solar powers your home, excess charges the battery, the grid fills any gap. No active trading.
If your solar is AC-coupled. Curtailing stops your battery exporting, but it can't switch off a separate solar system. So if your solar runs on its own (AC-coupled), some spare power may still flow to the grid during a curtail. If it runs through the battery (DC-coupled), export stops completely. It's about how your system is wired, not your battery brand.

The decision history

Every decision the engine makes is logged. Open the History tab to see them in order, with the action chosen, the price at the time, the battery state of charge, and a plain-English reason.

Decisions you triggered manually are tagged with a Manual pill so they're easy to spot. Engine decisions show a one-line reason like "exporting at 22.4c with 75% charge."

Filter the list by All, Export, Normal mode, Curtail or Charging to focus on one type at a time.

Decision history list with action, price, SOC and reason
Each row has the action, price, SOC, and reason.

03 · Your battery

Tesla Powerwall

Powerwall 2 and Powerwall 3 are both supported.

What you need: your Tesla account login. The onboarding flow opens Tesla's official sign-in page so you never give us your password. We get a token back that can be revoked any time from your Tesla account.

If the link breaks: changing your Tesla password or revoking third-party access invalidates the token and pauses your account. The dashboard shows a Reconnect button that takes you back through Tesla login.

For how AC-coupled solar inverters affect curtailment, see the note in How it works.

Sigenergy SigenStor

Sigenergy is supported. Two requirements before we can control your battery safely.

1. mySigen registration must be complete. Your installer needs to have finished the mySigen commissioning. Check by opening the mySigen app: if you can see your battery and SoC, you're good.

2. Amber SmartShift must be off. Toggle it off in the Amber app (see Getting started).

Once both are done, we control the battery via Sigenergy's command channel, with telemetry coming back through webhooks.

FoxESS

FoxESS uses a personal API key model. The homeowner generates a key in the FoxESS Cloud portal and pastes it during onboarding.

Important: the key must come from the homeowner account, not the installer account. Installer accounts can't bind to your battery for control purposes.

If you're not sure which account you have, check whether the FoxESS Cloud portal lets you change your battery's working mode. If it does, you have the right account.

04 · Settings & safety

Safety guardrails: what GridSentinel won't do

You're handing control of an asset that costs as much as a car. The engine has hard limits it will never cross, no matter which automation mode you're on.

  • Minimum battery reserve. Set in Settings, under Battery safety, from 5% to 50% in 5% steps. GridSentinel will never issue an export (sell) command that takes you below it; the rest of the time it sets normal mode and lets your battery self-consume. See the note below on how the floor is physically enforced for your battery.
  • No commands during onboarding. Until you've completed every step and tapped Activate, the engine ignores your account entirely.
  • Standby is always one tap away. Settings → Automation → Standby suspends the engine instantly. The battery returns to its default behaviour. Nothing about your battery configuration is permanently changed.
  • Observe only. A toggle that lets the engine evaluate and log decisions without sending any commands. Useful for watching what would happen before letting it act.
  • Disconnect is always one tap away. Settings → Linked services → Disconnect removes our access and stops further commands.
  • Auto-pause on repeated failure. If the engine hits errors on three consecutive cycles, your account is automatically paused as a safety net. Our team is alerted automatically.
How the reserve floor is enforced. GridSentinel has no direct electrical control; it sends mode commands and your battery's firmware holds the physical floor. On Tesla Powerwall and FoxESS, GridSentinel sets your battery's own backup reserve to match your GridSentinel figure automatically (FoxESS never discharges below 10%). On Sigenergy, GridSentinel can't change the reserve, so the value set in your Sigenergy app is what protects the battery during self-consumption; set it to match. Keeping the two figures equal is the safe choice either way.

Basic Rules: sell threshold, buy threshold, grid charging

Basic Rules has three controls you set yourself, all under Settings → Basic Rules.

Sell threshold (export). The feed-in price (cents per kWh) above which GridSentinel exports from your battery. Default 20c. Higher means you only export on bigger price spikes; lower means you export more often but earn less per spike. Minimum 10c, with a confirmation prompt below 15c because lower thresholds cycle the battery harder.

Grid charging toggle. Master switch for charging from the grid, found in Settings → Basic Rules. It's on by default, but because the buy threshold below starts at 0c, the battery only charges from the grid when import prices go negative. Turn it off if you never want to draw from the grid, whatever the price.

Buy threshold (charge). The import price below which the engine charges your battery from the grid. Default 0c, so charging only kicks in when import prices go negative. Raising the threshold lets the engine charge more often, but only when prices fall below the value you set. Range -10c to +20c.

Basic Rules controls
Three controls. Move, save, done.

Notifications

Settings → Notifications has a single toggle: Mode changes. When on, you get a push notification when the engine moves to Export, Charge or Curtail. Normal-mode (self-consume) transitions are excluded so you're not pinged every five minutes on volatile days.

Notifications run on all your signed-in devices.

Notifications settings
One toggle, deliberate.

Security: passkeys, authenticator, app lock

GridSentinel can move energy in and out of your Amber account, so security matters. Three pieces.

Passkey. A passwordless sign-in method backed by your phone's Face ID or fingerprint. Set up during onboarding. You can add more passkeys on additional devices, or remove all passkeys, from Settings.

Authenticator app (TOTP). Optional, set up via QR code in Settings. Useful if you'd rather use Google Authenticator, 1Password or similar as a backup sign-in method.

App Lock. A toggle in Settings that requires biometrics to open the app. Locks the app when it goes into the background.

Sensitive in-app actions (manual control, removing sign-in methods, disconnecting your battery) also prompt for a quick re-verification even when you're already signed in. This isn't a setting you toggle; it's always on for those actions.

Manual control

Tap the mode card on the dashboard to open manual controls. Pick a command, pick how long it runs for, confirm.

Commands: Export, Charge, Normal mode, Curtail.

Durations: 15, 30, 60 or 120 minutes. The dashboard shows a countdown while a manual command is active. Normal automation resumes when the timer ends, or when you tap cancel.

Two safety prompts can appear before a command runs:

  • If you choose Export and the current feed-in price is negative, you're warned that exporting now will cost you money.
  • If your battery state of charge is close to your minimum reserve, you're warned that the export may stop quickly once the reserve is reached.

Your minimum reserve still applies to manual commands.

Manual control panel
Command, duration, confirmation.

Pausing GridSentinel

Two ways to stop the engine.

Standby (soft). Settings → Automation → Standby. The engine stops sending commands but stays linked to your battery. Manual controls still work. Switch back to any automation mode any time.

Disconnect (hard). Settings → Linked services → Disconnect. Removes our access and credentials. You'd need to re-onboard the battery to use GridSentinel again.

For a temporary break (going on holiday, having work done), Standby is the right choice.

05 · More answers

Troubleshooting, subscription and billing, privacy and account questions live in the FAQ, so there's one place to look and nothing drifts out of sync:

?
Troubleshooting
Paused reasons, connection issues, negative earnings, unexpected behaviour.
$
Subscription & billing
Plans, the free trial, cancelling, refunds, what happens if it lapses.
Privacy, account & data
What we keep, deleting your account, disconnecting, contacting us.

The fastest way to reach us is in-app: Settings → Feedback & Support sends a report with diagnostic info attached. Or email hello@gridsentinel.app.