OPNsense Device Control for Home Assistant

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

1. Generate OPNsense API credentials (System → Access → Users)
2. Configure secrets.yaml with API key/secret
3. Run device discovery script to find all devices
4. Configure MAC addresses in Home Assistant
5. Create firewall aliases and rules in OPNsense
6. 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