Changes
Loading...
Last Saved
🤖 Automation & Data Refresh Synced
Controls how often automation runs and how frequently each data source refreshes.
Automation Cycle Interval
How often automation rules are evaluated
sec = 1.0m
Pricing Data Cache
Pricing data refresh interval
sec = 1.0m
Inverter Data Cache
Inverter API data refresh interval
sec = 5.0m
Weather Data Cache
Weather forecast refresh interval
sec = 30.0m
Frequently Asked Questions
What should I tune first?
Start with Automation Cycle Interval and Pricing Data Cache. Keeping both around 60 seconds gives responsive rule decisions without excessive API traffic.
Why is inverter cache usually longer than the cycle interval?
Inverter APIs often have stricter rate limits than local rule evaluation. A 5 minute inverter cache avoids unnecessary API pressure while automation can still run every minute using fresh-enough telemetry.
How do these intervals work together?
Each automation cycle evaluates rules using the latest available cached values. If a cache has expired, that source is refreshed first, then used by the same cycle.
Inputs on this page are in seconds; values are converted to milliseconds when saved to the API. If you see frequent API throttling, increase cache intervals before increasing the automation cycle interval.
What defaults are recommended?
Recommended baseline: 60s automation, 60s pricing, 5m inverter, 30m weather. Adjust only if you have a clear need for faster or slower refresh behavior.
🌙 Automation Blackout Windows Synced
Time periods when automation is paused. Useful for maintenance, peak tariffs, or overnight periods.
No blackout windows configured
Frequently Asked Questions
When would I use a blackout window?
Common use cases include:
Overnight quiet hours — Pause automation from 11pm-6am when you don't want mode changes
Scheduled maintenance — Temporarily disable automation during system updates
Peak demand events — Prevent discharge during grid emergencies when you want to keep battery full
Do blackout windows work overnight (crossing midnight)?
Yes! A window from 22:00 to 06:00 correctly spans midnight. The system understands that the end time is on the following day.
What happens during a blackout window?
Automation cycles are completely skipped — no rules are evaluated and no actions are taken. Your inverter continues running in whatever mode it was in before the blackout started.
Active scheduler segments from before the blackout will continue running until they expire naturally.
☀️ Solar Curtailment Synced
Automatically reduce export power to 0 when feed-in price falls below your threshold. Prevents negative revenue during low or negative price periods.
Solar Curtailment Status
Click to enable automatic export control
Price Threshold (cents/kWh)
Curtail solar export when feed-in price drops below this value. Range: -999 to +999 cents/kWh. Default: 0 (curtail when price ≤ 0)
cents/kWh
🛠️ Manual Override (Advanced)
⚠️ Last Resort Tool
Use these controls only if curtailment automation fails or your inverter gets stuck at 0W export. These directly query and modify inverter settings, bypassing normal automation.
Current Export Limit
Read the current ExportLimit setting from your inverter
Force Set Export Limit
Manually set ExportLimit value (0 = curtailed, 12000 = normal)
W
💡 Quick Actions:
• Set to 12000W to restore normal solar export
• Set to 0W to manually curtail export
• Always read current value first to verify state
How Solar Curtailment Works
When does curtailment activate?
During each automation cycle (every 1 minute by default), the system checks if:
• Curtailment is enabled
• Current feed-in price is below your threshold
If both conditions are met, export power is set to 0 watts.
When does it restore normal operation?
When the feed-in price rises above your threshold, export power is automatically restored to 12000 watts (normal operation). The system tracks state to avoid sending redundant commands to your inverter.
How does this interact with automation rules?
Curtailment runs AFTER automation rules in each cycle. If a rule updates your scheduler segments, curtailment will execute afterward. Both can operate in the same cycle without conflict.
Curtailment failures won't affect your automation rules — they execute independently.
What if curtailment fails?
If the system can't update export power (e.g., inverter offline, API error), an alert will appear on your dashboard. The automation cycle continues normally — curtailment errors don't disrupt rule execution.
🔑 Credentials Synced
Configure your inverter device serial number, inverter API token, and pricing API key. Tokens are not shown by default for security — enter them when you want to update them.
Inverter Device Serial Number
The serial number of your inverter (visible in your inverter provider portal)
Inverter API Token
Enter an inverter API token to allow the server to read inverter data (kept hidden)
Pricing API Key (optional)
Optional API key for electricity pricing data (used for automation)
Checking...
🌤️ Preferences Synced
Configure your personal preferences for the dashboard, including default weather location. The location also sets the timezone used by automation rules.
Default Weather Location · sets timezone
City and country for local weather forecasts (e.g., "Sydney, Australia") — also determines the timezone used by all automation rules
Default Forecast Days
Number of days to display in weather forecast (1-16)
days
Frequently Asked Questions
Why is weather location important?
Your weather location determines the local timezone, sunrise/sunset times, and cloud cover forecasts — all critical for solar production predictions. Getting the location correct ensures automation reacts appropriately to local weather conditions. For example, a forecast heavy rain in your area will reduce solar output and might trigger battery discharge modes to maximize export during remaining sunny hours.
Use the format "City, Country" (e.g., "Sydney, Australia" or "Melbourne, Australia") for best results.
How does location affect my automation rules?
Location determines the actual sunrise/sunset times and cloud cover for your area. If you set a rule like "Discharge during peak export hours", the system uses your location to calculate when peak sun is expected. Wrong location = wrong time windows = suboptimal discharge timing. Additionally, timezone information from your location is used to align with local electricity-market data (pricing providers use local times).
What happens if I change my location?
The system will fetch new weather data for the new location on the next update cycle. Historical weather data for the old location is discarded, and your weather cache resets. Automation rules will immediately start using the new sunrise/sunset times and timezone. No manual adjustment needed.
Why does weather data cache for 30 minutes?
Weather forecasts typically update hourly from data providers. A 30 minute cache reduces unnecessary API calls while keeping your forecast fresh enough for automation decisions. Shorter caching would hit rate limits; longer caching might miss rapid weather changes like sudden cloud cover.
Can I use coordinates instead of a city name?
Currently, the system accepts location names (e.g., "Sydney, Australia"). The weather provider resolves the name to coordinates internally. Using specific addresses or coordinates isn't supported, but city/state is precise enough for weather forecasting.
How many forecast days should I use?
6 days (default) is ideal for most users — it's enough to plan weekly without overwhelming the UI. If you want to see longer-term trends, increase to 10-16 days. For real-time operation focused on today/tomorrow, reduce to 2-3 days.
More forecast days = slightly slower dashboard load times. Balance visibility with performance.
💪 System Hardware Synced
Your inverter and battery specifications. These values are used throughout the app for power limits, energy estimates, and time-to-full/empty calculations.
Inverter Capacity
Rated output power of your inverter (sets the maximum for charge/discharge controls)
kW
Battery Capacity
Usable energy capacity of your battery pack (used for time-to-full/empty estimates on the dashboard)
kWh
Frequently Asked Questions
Where do I find my inverter capacity?
Check the nameplate on your inverter or its datasheet. It is often labelled Rated AC Output Power. Common sizes are 5, 8, 10, 12 and 15 kW.
What is usable battery capacity?
Usable capacity is the energy available between the minimum and maximum state-of-charge limits (often 10%–90% of rated capacity). For a 50 kWh pack at 10–90%, usable = 80% × 50 = 40 kWh. Check your battery's technical spec sheet.
📋 Automation Rule Defaults Synced
Default values used when creating new automation rules. Existing rules are not affected.
Default Cooldown
Minimum time between rule triggers
minutes
Default Duration
How long scheduler segments run
minutes
Default Power
Battery charge/discharge power setting
watts
Frequently Asked Questions
What is the cooldown and why does it matter?
Cooldown prevents a rule from triggering repeatedly in quick succession. For example, if prices fluctuate around your threshold, a 5 minute cooldown prevents the rule from toggling on/off every cycle. This protects your battery from excessive cycling.
How does duration affect my scheduler?
When a rule triggers, it creates a scheduler segment lasting this many minutes. After the duration expires, the inverter returns to its default mode. 30 minutes is a good balance for most price arbitrage scenarios.
Set shorter durations (15-20 min) if prices change frequently, longer (45-60 min) for more stable pricing periods.
What power setting should I use?
This controls how fast your battery charges/discharges. 5000W is typical for most home setups. Lower values (3000W) are gentler on the battery; higher values (7000-10000W) maximize throughput but increase wear.