Platform Admin

HomePassport SaaS Management

Forgot your password?
Back to Sign In

Enter the 6-digit code from your authenticator app, or a backup code.

← Back to Sign In

HomePassport SaaS

Platform Management
Client Admin View · Sign Out

Platform Overview

Revenue & New Clients — Last 6 Months
Plan Distribution
Upcoming Payments
Recent Activity

Client Portals

OrganisationSlugProvider CodePlanUsersPropertiesSensorsStatusActions

All Users

NameEmailRoleTenantConfirmedCreatedActions

Provider Code Requests

OrganisationCurrent CodeRequested ByReasonStatusDateActions

Activity Log

TimeActionUserEntityDetailsIP

Email & Notifications

Sender Configuration

Set the "From" address for all outgoing emails. Must be a verified sender signature in your Postmark account.

Format: Display Name <email@domain.com> — Leave empty to use the default Postmark sender address.

Notification Recipients

These email addresses receive new user registration alerts, email confirmations, and damp & mould reports.

Comma-separated list of email addresses. Leave empty to disable notification emails.

Alert Recipients (High Risk)

These email addresses receive urgent alerts for high-risk mould readings from IoT sensors (Awaab's Law compliance).

Comma-separated list. These recipients get critical HIGH RISK mould alerts requiring 24-hour action.

Send Test Email

Verify your email configuration by sending a test message.

Email Templates

Manage the content and layout of all outgoing emails. Use {{mergeTag}} syntax for dynamic content.

Edit Template

Lowercase letters, numbers, and hyphens only. Used to reference this template in code.

Plans & Billing

Stripe Sync Results

Edit Plan


Usage Limits

Use -1 for unlimited.


Features


Pricing (GBP)

Financials

Revenue by Client

Client Plan Status Monthly Rate Total Paid Last Payment Next Payment

Upcoming Payments

Recent Invoices

MQTT / IoT Settings

Configure the platform-level MQTT broker that all tenant gateways connect to. Tenant admins simply register gateways — they automatically use these settings.

The MQTT broker all gateways will connect to. Supports mqtt:// and mqtts:// protocols.
Default topic subscription for new gateways. Use # for wildcard. Individual gateways can override this.

Home Monitoring System Guide

Home Monitoring System

Full reference — environmental sensors, energy clamps, gateway architecture, and data flows

System Overview

HomePassport combines two complementary monitoring systems in every property: a Zigbee-based environmental sensor network and a WiFi-connected energy clamp system. Together they provide a complete picture of property health — temperature, humidity, air quality, mould risk, and real-time energy consumption.

🌡️ Environmental Sensors (Zigbee)

Battery-powered Zigbee sensors in each room report temperature, humidity, CO₂, and VOC via the SLZB-06 gateway. Data flows through a WireGuard VPN tunnel to the central MQTT broker. Enables Awaab's Law compliance and mould risk tracking.

⚡ Energy Clamps (Shelly EM Gen 3)

Shelly EM Gen 3 current-clamp meters clip onto circuits in the consumer unit. They connect to property WiFi and POST readings (watts, kWh, current, power factor) directly to the platform every 60 seconds via HTTPS. No gateway required.

Both systems are independent — a property can have sensors only, clamps only, or both. All data is scoped to the property and tenant, and appears in the tenant app and admin portal automatically.

System Architecture & Data Flow

┌──────────────────────────────────────────────────────────────────────────────────────────────────┐
│                                       PROPERTY  (per home)                                       │
│                                                                                                  │
│   ─── ENVIRONMENTAL MONITORING ────────────────────────  ─── ENERGY MONITORING ───────────────   │
│                                                                                                  │
│   ┌──────────┐  ┌──────────┐  ┌──────────┐               ┌─────────────┐  ┌─────────────┐       │
│   │  Zigbee  │  │  Zigbee  │  │  Zigbee  │               │  Shelly EM  │  │  Shelly EM  │       │
│   │  Sensor  │  │  Sensor  │  │  Sensor  │               │   Gen 3     │  │   Gen 3     │       │
│   │ (Bedroom)│  │ (Living) │  │(Kitchen) │               │ (Heat Pump) │  │ (Main Feed) │       │
│   └────┬─────┘  └────┬─────┘  └────┬─────┘               └──────┬──────┘  └──────┬──────┘       │
│        │              │              │                            │                 │              │
│        └──────── Zigbee mesh ────────┘               WiFi → HTTPS POST (60 s)      │              │
│                       │                                          └─────────────────┘              │
│                 ┌─────┴──────┐                                          │                        │
│                 │  SLZB-06   │  Zigbee coordinator                      │                        │
│                 │  Gateway   │  (pre-configured)                        │                        │
│                 └─────┬──────┘                                          │                        │
│                       │  WiFi (property broadband)                      │                        │
└───────────────────────┼─────────────────────────────────────────────────┼───────────────────────┘
                        │                                                 │
               WireGuard VPN tunnel (auto)                       HTTPS webhook POST
                        ▼                                                 │
               ┌─────────────────────┐                                    │
               │  Central Mosquitto  │  Cloud MQTT broker                 │
               │  Broker + Z2MQTT    │  (all gateways, always-on)        │
               └──────────┬──────────┘                                    │
                          │                                                │
                          ▼                                                ▼
               ┌──────────────────────────────────────────────────────────────────┐
               │                    HomePassport Server                        │
               │         MQTT subscriber               Webhook receiver           │
               │        (sensor telemetry)            (energy readings)           │
               └──────────────────────────────┬───────────────────────────────────┘
                                              │
                    ┌─────────────────────────┼─────────────────────────┐
                    ▼                         ▼                         ▼
           ┌─────────────────┐    ┌─────────────────────┐    ┌──────────────────┐
           │   Tenant App    │    │    Admin Portal      │    │   Compliance     │
           │ Temp · Humidity │    │  Dashboards · Energy │    │   Alerts         │
           │ Energy · Mould  │    │  Reports · Alerts    │    │  (Awaab's Law)   │
           └─────────────────┘    └─────────────────────┘    └──────────────────┘

Hardware Components

SLZB-06 Gateway
  • SMLIGHT SLZB-06 (or compatible variant)
  • Zigbee 3.0 coordinator + WiFi + Ethernet
  • Pre-configured with WireGuard + Z2M firmware
  • Powered by USB-C
  • Setup hotspot on first use only
  • One per property
  • ~£28 per unit
Zigbee Sensors
  • Any Zigbee 3.0 temp/humidity/air quality sensor
  • Recommended: Frient, Develco, Aqara, IKEA
  • Pairs directly to the SLZB-06 gateway
  • Battery-powered (~2 year life)
  • Wall-mountable, compact
  • Auto-discovered by the platform on pairing
  • ~£15–35 per sensor
Shelly EM Gen 3
  • Gen 3 only — Gen 1/2 not supported
  • WiFi-connected current clamp meter
  • Up to 2 channels (dual-circuit monitoring)
  • Reports watts, kWh, A, V, power factor
  • Fits in consumer unit, no rewiring needed
  • Configured via admin portal "Add Clamp" wizard
  • ~£35–45 per unit

Platform Infrastructure

No setup required. All platform infrastructure — the MQTT broker, Zigbee2MQTT, WireGuard VPN server, and webhook endpoints — is operated by HomePassport. Gateways ship pre-configured and connect automatically. Energy meters are configured through the admin portal in minutes.
Central MQTT Broker

Single always-on Mosquitto broker. All gateways across all tenants connect to it. Credentials embedded in gateway firmware.

Zigbee2MQTT (Z2M)

Translates Zigbee messages into structured JSON. Runs centrally — no local Z2M installation at properties.

WireGuard VPN

Each gateway auto-creates an encrypted VPN tunnel. No port-forwarding or router config required.

Webhook Endpoint

Per-device HTTPS endpoint for Shelly EM POSTs. Authenticated with a unique webhook secret per meter.

Installation Workflows

Gateway & Sensor Setup

1

Power On

Plug in SLZB-06 via USB-C. Wait for setup hotspot.

2

Enter WiFi

Connect to HomePassport-Setup-XXXX hotspot → open 192.168.4.1 → enter property WiFi credentials

3

Pair Sensors

Admin enables permit-join in portal. Reset each sensor — it auto-discovers and registers.

✓

Online

WireGuard connects automatically. Live readings appear in dashboards.

Energy Clamp Setup (Shelly EM)

1

Connect to WiFi

Power on Shelly EM. Connect it to property WiFi via Shelly app or AP hotspot (192.168.33.1).

2

Add Clamp

Admin opens Energy tab → Add Clamp. Enters device name, device ID, and local IP. Portal generates webhook URL + script.

3

Paste Script

Open Shelly local web UI → Scripts → Add Script. Paste the generated script. Toggle On.

✓

Live Data

Within 60–90 s the portal confirms data received. Live wattage appears in the energy dashboard.

No gateway needed for energy clamps. Shelly EM Gen 3 meters connect directly to property WiFi and report via HTTPS. They operate independently of the Zigbee gateway — a property can have one, the other, or both.

What Happens With the Data

🌡️ Environmental Dashboard

Tenants see live temperature, humidity, and air quality grouped by room. Historical charts show trends over time.

⚡ Energy Dashboard

Live wattage, today's kWh, daily/monthly charts. Dual-channel meters show per-circuit breakdown. Estimated cost included.

⚠️ Automated Alerts

Humidity and temperature thresholds trigger push notifications. Daily kWh limits can be set per meter — alert fires if exceeded.

🏛️ Awaab's Law Compliance

Dew point calculated automatically. Mould risk levels (LOW/MEDIUM/HIGH) set legal response deadlines and trigger admin alerts.

🔌 CT Clamp Health

Platform detects reversed clamps, open clamps, and low power factor faults automatically. Push notification sent on fault and recovery.

📈 Portfolio View

Admins see a portfolio-level energy summary — total live watts, today's kWh, monthly kWh, and estimated cost across all metered properties.

Troubleshooting FAQ

Gateway shows "Offline" but it's powered on

Check the gateway has working WiFi. The WireGuard tunnel establishes automatically once internet is available. If still offline after 5 minutes, power-cycle the gateway and wait another 2 minutes. Contact support with the gateway serial number if the issue persists.

No sensor data appearing after pairing

Confirm pairing mode was enabled (Enable Sensor Pairing) before resetting the sensor. Wait up to 2 minutes for the first reading. Try power-cycling the sensor (remove and reinsert the battery). Ensure the sensor is within 10–15 m of the gateway.

Shelly EM: no energy data after 90 seconds

In the Shelly local web UI → Scripts, confirm the script exists and its toggle is On. Confirm the Shelly has a valid IP on the property network — if it's still showing its own AP (192.168.33.1), it hasn't joined WiFi yet. Reconnect and re-enter WiFi credentials.

Energy meter shows a CT clamp fault (reversed / open)

"Reversed" means the clamp is fitted backwards — flip the clamp orientation on the cable. "Open" means the clamp may not be fully closed around the cable or is disconnected. Re-seat the clamp and wait 5 minutes for the platform to re-evaluate health.

Multiple properties — do I need separate brokers or webhook endpoints?

No. One central MQTT broker and one webhook receiver serve the entire platform. Multi-tenancy is handled automatically — each gateway and each Shelly meter is scoped to its property. No per-tenant infrastructure configuration is needed.

Sensor was paired before but now shows as offline

Check the battery level first — below 10% often causes reporting to stop. If battery is fine, re-pair using Enable Sensor Pairing and reset the sensor. If a duplicate record appears, use Unassign on the old one and keep the newly paired record.

Gateway & Sensor Manager

—
Total Gateways
—
Connected
—
Offline / Pending
—
Total Sensors
Loading gateways...
No gateways found.
Gateway Tenant Property Status Sensors Last Seen Actions

Gateway Sensors

Loading...

Tenant Engagement Overview

Tenant Plan Users Active (7d) Active % Logins Avg/User Reports Tasks %

Legal Compliance Checklist

How to use this checklist. Items marked Done in app are already implemented in the HomePassport platform. All remaining items are organisational responsibilities — actioned by your organisation or each housing provider client, not the software. Work through these with your Data Protection Officer (DPO) or legal counsel before going live with paying clients. Tick items as you complete them — your progress is saved automatically.
0 / 0 complete

Energy Meters

Total Meters
-
Online
-
Offline
-
Faults
-
Loading…

Properties — Platform Overview

TenantProperty NameAddressCodeEPC BandSensorsGatewaysAdded
Loading...

System Health

Platform Row Counts
Process Resources
Recent Platform Activity
TimeActionUser IDEntityIP
Loading...

Create New Client Portal


Optionally create an admin user for this client:

Edit Client Portal

Users-
Properties-
Sensors-
Damp Reports-

Create Superadmin Account

Superadmins have full access to the platform, all tenants, and all settings.

Edit User


Gateway Details

Rename Gateway

Rename Sensor

Edit Energy Meter

Enter in pounds (e.g. 0.28 = 28p/kWh). Leave blank to clear.
Send push alert when this kWh threshold is exceeded in a day. Leave blank to disable.