A comprehensive system for discovering, managing, and controlling internet access to devices through OPNsense firewall integration with Home Assistant.

Repository

🔗 https://gitea.hideawaygaming.com.au/jessikitty/opnsense-device-control

Features

Device Discovery: Automatically discover all devices on your network
MAC-Based Blocking: Block internet access by MAC address (prevents circumvention)
Per-Device Control: Individual blocking for each device
User-Wide Control: Block all devices for a user with one toggle
Tablet-Optimized Dashboard: Clean, intuitive interface for easy management
Multiple MAC Support: Handle devices with both wired and WiFi connections
Real-Time Status: See which devices are blocked at a glance

Quick Start

Generate OPNsense API credentials (System → Access → Users)
Configure secrets.yaml with API key/secret
Run device discovery script to find all devices
Configure MAC addresses in Home Assistant
Create firewall aliases and rules in OPNsense
Install dashboard for control interface

Files

opnsense_device_control.yaml - Home Assistant configuration
lovelace_device_control.yaml - Tablet-optimized dashboard
opnsense_device_manager.py - Device discovery Python script
secrets.yaml.example - API credentials template
FULL_DOCUMENTATION.md - Complete setup and usage guide

Family Configuration

Pre-configured for:

Bella (14) - Phone + Tablet
Xander (15) - Phone + Desktop
William (17) - Phone + Laptop

Easily customizable!

Network

OPNsense: 10.0.0.254
Home Assistant: 10.0.0.55
LAN: 10.0.0.0/24