This article guides you through setting up the Octopus Energy Home Mini, a smart energy monitor, and integrating it with Home Assistant for comprehensive home energy management. The Home Mini directly connects to your smart meter, providing real-time and historical energy consumption data via the Octopus Energy app and API. This allows for detailed tracking of your energy usage, offering valuable insights into your consumption habits. While the Home Mini's real-time solar export data is currently only visible within the Octopus app, the integration with Home Assistant offers a centralized dashboard for all your energy information.This tutorial covers the initial setup of the Home Mini, including connecting it to your Wi-Fi network and configuring it within the Octopus Energy app. It then details the process of integrating the device with Home Assistant, leveraging the 'hacks' add-on and the Octopus Energy API. We'll walk you through the necessary steps, including adding your account details and troubleshooting potential issues like undefined statistics during initial data population. By the end, you'll have a powerful smart home energy monitoring system at your fingertips.
Pros And Cons
- Communicates with smart meter and uploads data to Octopus.
- Allows access to energy data from the app and Home Assistant.
- Shows current and historic data.
- Displays solar export in real time on the app.
- Simple setup via QR code scan and app instructions.
- Requires Octopus Energy account.
- Requires a smart meter.
- May involve a waiting period before shipment.
- Solar export data not yet supported in Home Assistant.
Read more: AMI Meter Reading Guide: Understanding Your Smart Electricity Meter
Octopus Energy Home Mini Overview
The Octopus Energy Home Mini is a compact device designed to simplify energy monitoring. Developed in-house by Octopus Energy, it directly communicates with your smart meter, seamlessly uploading your energy consumption data to the Octopus Energy app and API.

This integration allows for convenient access to your energy usage data from anywhere at any time. View both real-time and historical energy consumption patterns, providing valuable insights into your energy habits.

A key feature is the real-time solar export data displayed in the app, although this functionality is not yet integrated into Home Assistant. To use the Home Mini, you must be an Octopus Energy customer.

Home Assistant Integration
Integrating the Home Mini with Home Assistant enhances your smart home experience. The integration connects to the Octopus Energy API, enabling you to view your energy data directly within your Home Assistant dashboard. This provides a central location for managing and monitoring your home's energy consumption.

The setup process requires the installation of the 'hacks' add-on in Home Assistant. Refer to the video description or an earlier video for detailed installation instructions. The integration also requires setting up the repository to 'hacks' using a provided GitHub link.

Follow the step-by-step guide on the GitHub page or in the video description to complete the integration. Remember to properly input your account ID and API key from your Octopus Energy account to connect the Home Mini to Home Assistant.

Home Mini Setup and Configuration
Setting up the Octopus Home Mini is straightforward. After receiving your device, download the Octopus Energy app, scan the QR code included in the booklet, and connect the device to your home Wi-Fi network using the app's instructions.

Once connected, the Home Mini will communicate with your smart meter and begin collecting energy data. You'll then need to configure the integration in Home Assistant, adding the electricity and gas meter details for accurate monitoring. This involves setting up entities to track energy consumption and costs.

During the configuration process, you might encounter a message indicating undefined statistics. This is usually temporary and will resolve as the device fetches and populates the data. Allow sufficient time for data to populate fully.

Conclusion
The Octopus Energy Home Mini offers a convenient and effective way to monitor your energy consumption. Its integration with Home Assistant provides a centralized view of your energy usage, enhancing your smart home experience.

While the real-time solar export feature is currently limited to the Octopus app, the detailed energy data and straightforward setup make it a valuable tool. If you're an Octopus Energy customer, incorporating the Home Mini into your Home Assistant setup is strongly recommended.
The detailed instructions provided, along with the readily available support resources, make this project achievable even for those less experienced with Home Assistant. Keep in mind that the data population may take several hours before it's fully visible on the dashboard.