The Energy module turns FreeMaint into a full energy and utility management hub. Track, parametrize and control electricity, water, gas, steam, compressed air, fuel and oil — plus your own on-site generation such as solar. Every reading is automatically priced and converted into a carbon figure, so you can see consumption, cost and emissions side by side.

Where to find it

Open the Energy section in the sidebar (the /energy area of the app). From there you can reach the dashboard, meters, readings, configuration and the control panel.

Power capacity and load shedding

If you run on-site generators, set each generator meter’s rated capacity (kW) and, optionally, a demand cap per zone. The Energy dashboard then shows a live power-margin gauge — available capacity minus current load — company-wide and per zone, so everyone can see how much headroom remains. You can surface the same figures on a shared Wallboard screen, and rank which zones and breakers to shed first in a Load-shedding plan. This plan is decision-support only: FreeMaint shows the numbers and the recommended order, but the actual protective trip stays in your generator paralleling controller.

Permissions

Access is controlled by fine-grained permissions, so you decide exactly who can view, edit and actuate energy data.

• energy:read — view meters, readings and the dashboard
• energy:create — add meters and record readings
• energy:update — edit meters and configuration
• energy:delete — remove meters and configuration
• energy:configure — manage tariffs, emission factors and targets
• energy:control — actuate devices and supply (sensitive; admin-only by default)

Three pillars

The module is built around three complementary capabilities. You can adopt them progressively — start by monitoring, then refine your configuration, and finally enable control when you are ready.

• Monitor: create meters, record readings, and watch a live dashboard with cost and carbon per utility and per zone.
• Configure: define zones, tariffs, emission factors and targets so every reading is priced and benchmarked correctly.
• Control: actuate connected devices, run lighting schedules, build automation rules and link external connectors.

Availability

Energy monitoring — meters, readings, tariffs, targets, dashboards and connectors — is part of the Business tier. Controlling equipment (devices, schedules, automation rules and remote commands) requires the Enterprise tier. Once enabled, an administrator can grant the relevant permissions to the right people.

Meters are the foundation of the Energy module. Each meter measures one utility at one point of your site, and every reading you record is automatically turned into a cost and a carbon figure.

Creating a meter

When you add a meter, you describe what it measures and where it sits. These choices drive how readings are interpreted and aggregated on the dashboard.

• Utility type: electricity, water, gas, steam, compressed air, fuel or oil.
• Unit: the measurement unit such as kWh or m³.
• Direction: consumption (energy you draw) or generation (energy you produce, e.g. solar).
• Reading type: cumulative (an ever-increasing index) or interval (the amount used in a period).
• Zone or location: assign the meter to a zone so consumption rolls up by area.

The dashboard

The dashboard aggregates your data so you can spot trends and overspend at a glance.

• Consumption, cost (in your company currency) and carbon (kgCO₂e) per utility.
• The same breakdown per zone, so you can compare areas of the site.
• A monthly trend to see whether usage is rising or falling.
• Target variance, showing actual against the budgets you have set.

Cumulative meter safeguard

For cumulative meters, a new reading should normally be higher than the previous one. If you enter a value that is lower — which usually means a meter reset or rollover — FreeMaint asks you to confirm explicitly before saving, so accidental typos do not corrupt your history.

Recording readings

You can record readings one at a time or in bulk. As soon as a reading is saved, cost and carbon are computed automatically from the active tariff and emission factor, and stored on that reading — no manual calculation needed.

Tariffs, emission factors and targets are the configuration layer that gives meaning to your readings. They decide how much each unit costs, how much carbon it represents, and how your actual usage compares to your goals.

Emission factors

An emission factor expresses how much carbon a unit of a given utility produces, in kgCO₂e per unit. Define one per utility so each reading is converted into a carbon footprint alongside its cost.

Targets and budgets

Targets let you set a budget per period and track performance against it. You can scope a target broadly or narrowly to match how you manage the site.

• Choose a period: month, quarter or year.
• Optionally scope the target to a specific zone or meter.
• Set a target for consumption, cost or carbon.
• The dashboard then shows target versus actual so over- or under-performance is obvious.

Tariffs

Define a tariff per utility to price every reading. You can keep it simple or model a real utility contract.

• A flat unit price for the simplest case.
• Time-of-use bands (peak / off-peak) defined by day-of-week and time window.
• An optional demand charge on top of the unit price.

The Control panel is where the Energy module moves from observing to acting. From here you operate connected devices, automate routine switching, and shed load — always with safety guardrails and a full audit trail.

Actuating devices

The Control panel can operate the connected equipment in a zone.

• Cut or restore electrical supply to a zone.
• Turn relays on or off.
• Set dimmer or HVAC levels.

Audit log

Every command is recorded in an audit log — who issued it, when, the reason given, and the result — giving you a complete and reviewable history of all control actions.

Automation rules

An automation rule triggers an action when a condition is met, such as a consumption threshold or a time of day. Actions that cut supply or shed load always require confirmation, so automation never operates critical equipment silently.

Safety first

Actuating physical supply is a sensitive action, so several safeguards are mandatory and cannot be skipped.

• Cutting or restoring supply requires the energy:control permission.
• A reason for the action is mandatory.
• An explicit confirmation is required before the command runs.
• Restoring supply to a zone with an active Lockout/Tagout (LOTO) is blocked until the lockout is cleared.

Lighting schedules

Lighting schedules switch zones or devices on and off automatically on a recurring weekly schedule — for example lights off overnight and on again before the first shift.

Connectors link your physical meters and gateways to FreeMaint so readings flow in automatically and commands can flow back out. The pairing model is designed to be plug-and-play with common hardware.

Control over connectors

To send commands back to your equipment, register the connector's command endpoint (an HTTPS URL). FreeMaint then sends signed commands to that endpoint, so the connector can trust and execute them.

Ingesting readings

Point your gateway at FreeMaint to push readings in automatically.

• Have your gateway POST readings to /api/v1/energy/ingest using the API key as a Bearer token.
• Typical hardware includes a Shelly Pro 3EM with relays, or a Home Assistant / Node-RED bridge.
• Map each physical meter to a FreeMaint meter using its external ID, so every reading lands on the right meter.

Pairing a connector

Pair a connector to generate an API key. The key is shown only once, so copy it immediately and store it securely — you can always rotate it later if needed.

Status and key rotation

Each connector card shows its current connection status. You can rotate the API key at any time — useful if a key may have been exposed or as part of routine security hygiene.