opnsense/core
32.2
Weak · 17 November 2026
111.2k
lines of production code
PHP
with JavaScript, Python
5
measurements over time
What this system is
Features
Add Bootstrap Datepicker and Dialog libraries to the web interface
The web interface now includes the bootstrap-datepicker (v1.7.1) and bootstrap-dialog JavaScript libraries. This addition provides users with standardized date selection controls and enhanced modal dialog capabilities across the UI, replacing previous ad-hoc implementations or external dependencies with these bundled, maintained components.
src/opnsense/www/js · high confidence
Add CSS assets for new UI components and libraries
The dashboard and general UI now include dedicated CSS stylesheets for newly integrated libraries and features. This adds support for the jqTree tree view, the bootstrap-select dropdown component, the GridStack widget layout engine (including extra column variants), and the jQuery Bootgrid table widget. Additionally, new styles are provided for the dashboard layout itself, Chart.js v4 compatibility, and the Unbound DNS overview page, ensuring consistent rendering for these interactive elements.
src/opnsense/www/css · high confidence
Add PHP Parallel Lint 1.3.2 to contrib
The \contrib/parallel-lint\ directory now includes the PHP Parallel Lint tool (version 1.3.2), providing a standalone PHP syntax checker that runs in parallel. This addition brings support for PHP Console Highlighter 1.0.0, fixes Phar file independence and PHP 8.1 compatibility, and corrects invalid XML generation in checkstyle reports. Users can now utilize this tool for parallel syntax linting with features like JSON/Checkstyle output, git blame integration, and file exclusion based on PHP version requirements.
contrib/parallel-lint · high confidence
Add default beep melody database files
The system now includes a set of default melody definitions for the beep service, located in the \src/etc/opnsense-beep.d\ directory. These new files (\high\, \low\, \start\, and \stop\) define specific frequency and duration sequences for various alert tones, allowing the beep service to play structured melodies instead of simple single tones.
src/etc/opnsense-beep.d · high confidence
Add monit monitoring scripts for CARP and gateway health
New PHP scripts have been added to the monit directory to monitor system health: \carp\_status.php\ checks the status of CARP interfaces (MASTER/BACKUP) and \gateway\_alert.php\ monitors gateway groups for down states, packet loss, or high latency. A \setup.sh\ script is also included to secure the monit configuration file permissions.
src/opnsense/scripts/monit · high confidence
Added Base32 encoder and decoder utility
A new Base32 encoding and decoding class has been added to the contrib/base32 directory. This utility implements RFC 4648 compliant encoding and decoding, allowing users to convert strings to and from Base32 format using the standard alphabet.
contrib/base32 · high confidence
Added IANA reference data for DHCP and time zones
The repository now includes static CSV and tab-separated files in contrib/iana containing official IANA assignments for DHCPv4 and DHCPv6 options, as well as ISO 3166 country codes and timezone mappings. These files provide the underlying data definitions for network configuration and localization features, allowing the software to correctly interpret DHCP option codes and map geographic locations to time zones.
contrib/iana · high confidence
Added SVG flag icons for multiple countries
New 1x1 SVG flag icons have been added to the web interface for several countries, including the United Arab Emirates (ae), Afghanistan (af), Antigua and Barbuda (ag), and Anguilla (ai). These assets are now available for use in the UI, resolving the missing flag display issue referenced in the project tracker.
src/opnsense/www/css/flags · high confidence
Auto theme switching based on browser color scheme preference
The new 'opnsense-auto' theme automatically switches between the standard 'opnsense' and 'opnsense-dark' themes based on the user's browser settings (specifically the 'prefers-color-scheme' media query). This is implemented via a JavaScript loader that dynamically updates CSS and image links to match the detected theme, while also hiding the page content briefly during load to prevent visual flashing or 'blinking' as the correct assets are applied.
src/opnsense/www/themes/opnsense-auto · high confidence
Captive Portal: New frontend for session, template, and voucher management
The Captive Portal view layer has been rewritten to provide a modern interface for managing clients, authentication templates, and vouchers. The new Clients view allows administrators to filter active sessions by zone and disconnect them directly from the grid. A new Templates tab enables uploading, editing, and downloading custom HTML templates for the captive portal login page. Additionally, a dedicated Vouchers view supports creating, grouping, and downloading voucher CSV files, with validation to prevent invalid generation parameters.
src/opnsense/mvc/app/views/OPNsense/CaptivePortal · high confidence
Dnsmasq service configuration and startup logic
The Dnsmasq service now uses a new rc.d startup script and a comprehensive Jinja2 configuration template. The template generates the dnsmasq.conf file, enabling users to configure DNS rebinding protection, port/interface bindings, DHCP lease limits, and various DHCP options (including RA, ping, MAC/subnet handling, and logging). It also supports domain overrides with optional IPset integration, strict ordering, DNSSEC validation, and wildcard host handling. The startup script controls the service enablement state via rc.conf.d.
src/opnsense/service/templates/OPNsense/Dnsmasq · high confidence
Firewall UI migrated to MVC views with new alias, category, and migration interfaces
The Firewall section's user interface has been rebuilt using the MVC view layer, replacing the legacy PHP templates. This introduces a new Alias management page with a grid-based view, category coloring, and import/export capabilities, alongside a dedicated Alias diagnostics page for inspecting table contents. A new Category management interface allows users to organize firewall items with color coding and CSV import/export. Firewall Rules and NAT pages now feature a unified tree-view layout that groups rules by type (automatic, interface, floating) and category, with persistent expansion states. Additionally, a new Migration Assistant page guides users through exporting legacy rules and NAT configurations to the new MVC-based interfaces, including options to flush legacy rules after successful migration.
src/opnsense/mvc/app/views/OPNsense/Firewall · high confidence
IDS policy editor displays rule origin metadata
The Intrusion Detection System policy editor now shows the message and source origin for each rule in the adjustments grid. This is achieved by new model field types that fetch rule metadata via the backend, allowing users to see where rules originate directly within the policy configuration interface.
src/opnsense/mvc/app/models/OPNsense/IDS/FieldTypes · high confidence
Initial DHCP Relay configuration interface
The DHCP Relay settings page is now available in the GUI, allowing users to configure relay agents and their destinations. This change introduces the RelayController which renders the main relay view and provides the necessary form dialogs and grid views for managing relay and destination configurations.
src/opnsense/mvc/app/controllers/OPNsense/DHCRelay · high confidence
Initial IDS frontend controller stubs
Added the initial Index and Policy controllers for the Intrusion Detection System (IDS) module. These controllers wire up the necessary forms and grids (such as general settings, rule dialogs, and policy management) to their respective views, establishing the basic MVC structure for the IDS interface.
src/opnsense/mvc/app/controllers/OPNsense/IDS · high confidence
Initial Kea DHCPv4/v6 service configuration templates
This change introduces the initial set of configuration templates for the new Kea DHCP server plugin, replacing the previous DHCP implementation. It adds the \keactrl.conf\ script to manage the startup and status of Kea's DHCPv4, DHCPv6, DDNS, and Control Agent processes, alongside \rc.conf.d\ to enable the service when DHCP interfaces are configured. The entry also includes placeholder JSON configuration files (\kea-dhcp4.conf\, \kea-dhcp6.conf\, \kea-ctrl-agent.conf\) which are populated dynamically by the plugin's configuration hook, establishing the foundational service wiring for the new DHCPv4 replacement.
src/opnsense/service/templates/OPNsense/Kea · high confidence
Initial Monit service monitoring configuration model
The Monit service monitoring module is introduced, providing the underlying configuration model for managing system health checks. This change adds the \Monit.php\ and \Monit.xml\ files which define the schema for general settings (such as polling intervals, mail server connections with SSL options, and HTTP daemon access), alert recipients with event filtering, and service definitions for monitoring processes, files, filesystems, hosts, and systems. The model includes validation logic to enforce constraints like unique service names, valid test type mappings, and conditional requirements for alert events.
src/opnsense/mvc/app/models/OPNsense/Monit · high confidence
Initial NetFlow collection and aggregation service configuration
This change introduces the foundational configuration templates for the NetFlow feature, enabling traffic flow monitoring on the firewall. It adds templates for the \netflow\ daemon (handling capture and export), the \flowd\ daemon (collecting flows from the daemon), and the \flowd\_aggregate\ daemon (aggregating collected flows). Users can now configure capture interfaces, export destinations, flow versions (v5/v9), and active/inactive timeouts via the UI, with the system automatically generating the necessary rc.conf and service configurations to start these background processes.
src/opnsense/service/templates/OPNsense/Netflow · high confidence
Initial Traffic Shaper model implementation with CoDel/PIE support
The TrafficShaper model (TrafficShaper.php and TrafficShaper.xml) is introduced to define the data structure and validation logic for the traffic shaping feature. This includes configuration fields for pipes and queues, supporting bandwidth metrics (bit/s to Gbit/s), scheduler types (including FlowQueue-CoDel and FlowQueue-PIE), and specific parameters like CoDel target/interval and PIE enablement. The model enforces validation rules such as maximum bandwidth limits, mutual exclusivity between CoDel and PIE, and ID generation for new pipes and queues.
src/opnsense/mvc/app/models/OPNsense/TrafficShaper · high confidence
Initial import of Monit service configuration templates
This change introduces the core configuration templates for the Monit service within OPNsense. It adds the \monitrc\ template, which generates the main Monit configuration file by processing settings for the HTTP daemon, mail server (including SSL options), alerting rules, and service checks (process, host, network, system, and custom programs). It also adds the \rc.conf.d\ template to manage the Monit daemon's enable/disable state and setup script path, along with a \+TARGETS\ file to define the output locations for these generated files.
src/opnsense/service/templates/OPNsense/Monit · high confidence
Interfaces: Migrate configuration and management to MVC API controllers
The Interfaces section now uses a new set of MVC API controllers (Assignment, Bridge, GIF, GRE, LAGG, Loopback, Neighbor, Overview, Settings, VIP, VLAN) to manage interface configurations. This change provides a consistent, programmatic way to create, read, update, and delete interface types, including specific handling for dependencies (e.g., preventing deletion of interfaces in use by bridges or tunnels) and legacy configuration cleanup. Users interacting with the web UI will see these changes as the underlying mechanism for interface management, while API consumers gain access to these new endpoints for automation.
src/opnsense/mvc/app/controllers/OPNsense/Interfaces/Api · high confidence
Introduce Cron model with newDailyJob helper and validation schema
The Cron module now includes a model class (Cron.php) and an XML schema (Cron.xml) that define the structure and validation rules for cron jobs. The model provides a newDailyJob() helper method to create daily scheduled tasks, defaulting them to disabled (enabled=0) unless explicitly enabled, which requires a subsequent regeneration of the cron table. The schema enforces strict validation for job parameters including origin, schedule fields (minutes, hours, days, months, weekdays), user (who), command selection, and parameters, ensuring inputs conform to expected formats and lengths.
src/opnsense/mvc/app/models/OPNsense/Cron · high confidence
Introduce Favorites section in the navigation menu
The navigation menu now includes a new Favorites section that appears at the top of the menu for logged-in users. This section dynamically lists items that users have marked as favorites in their profile settings, providing quick access to frequently used pages. The implementation adds a new Menu model and XML configuration to support this feature, with the Favorites section ordered before other menu groups.
src/opnsense/mvc/app/models/OPNsense/Core/Menu · high confidence
Introduce Host Discovery API for network host monitoring
This change adds the API controllers for the new Host Discovery feature, enabling users to manage settings and retrieve discovered host data via the API. The SettingsController exposes the hostwatch configuration model, while the ServiceController provides a search endpoint that queries the underlying hostwatch service and returns a recordset including interface names, MAC and IP addresses, organization names, and first/last seen timestamps for each detected host.
src/opnsense/mvc/app/controllers/OPNsense/Hostdiscovery/Api · high confidence
Introduce Kea Control Agent and Dynamic DNS (DDNS) configuration models
The Kea DHCP service now includes dedicated configuration models for the Kea Control Agent and Dynamic DNS (DDNS). The Control Agent model allows users to enable and configure the HTTP host and port for managing the DHCP servers, while the DDNS model provides settings for the DNS server IP, port, and TSIG key management. These models work in conjunction with the existing DHCPv4 and DHCPv6 models to generate the necessary JSON configuration files for these components, enabling automated DNS updates and centralized control of the Kea infrastructure.
src/opnsense/mvc/app/models/OPNsense/Kea · high confidence
Introduce Kea DHCP controller for IPv4 and IPv6 management
The new DhcpController in the Kea module provides the backend routing for managing Kea DHCP services, including dedicated actions for general settings, DDNS configuration, and subnet/reservation/option management for both IPv4 and IPv6. It also exposes endpoints for viewing DHCP leases and controlling the Kea agent, serving as the central interface for the new DHCPv4 replacement and DHCPv6 capabilities.
src/opnsense/mvc/app/controllers/OPNsense/Kea · high confidence
Introduce MVC base controller hierarchy and exception types
This change adds the foundational controller classes for the new MVC framework in the \OPNsense\\Base\ namespace. It introduces \ControllerRoot\ to centralize authentication, session management, and language/locale handling, and \ControllerBase\ to provide the core view rendering engine (Volt) and default UI assets. It also defines specialized base controllers for API development: \ApiControllerBase\ for general API endpoints, \ApiMutableModelControllerBase\ for CRUD operations on configuration models, and \ApiMutableServiceControllerBase\ for managing service lifecycle (start/stop/restart). Additionally, a new hierarchy of exception classes (\UserBaseException\, \UserException\, \UserWarningException\, \UserInformationalException\) is added to standardize error handling and HTTP status reporting for user-facing errors.
src/opnsense/mvc/app/controllers/OPNsense/Base · high confidence
Introduce OPNsense Base MVC framework components
This change adds the foundational classes for the OPNsense Model-View-Controller (MVC) framework within the \OPNsense\\Base\ namespace. It introduces \BaseModel\ to handle binding configuration data to object models, including support for lazy loading, model versioning, and migration prefixes. A new \BaseModelMigration\ class provides a default strategy for applying model defaults during migrations. Validation is decoupled from the Phalcon framework via a new \Validation\ class and \BaseValidator\ abstract class, allowing for custom validation logic alongside Phalcon validators. Supporting classes include \ModelException\ for initialization errors, \ValidationException\ for validation failures, and \BaseValidator\ to standardize validator options.
src/opnsense/mvc/app/models/OPNsense/Base · high confidence
Introduce SSO provider abstraction and Kea DHCP option type system
This change adds a new \Provider\ class in the \OPNsense\\Auth\\SSOProviders\ namespace to serve as a minimalistic interface for Single Sign-On (SSO) support, enabling future integration of external identity providers. Simultaneously, it introduces a typed validation and encoding system for Kea DHCP options via the new \KeaOptionDataField\ model and \KeaEncoding\ enum, which enforces specific data types (such as IPv4, IPv6, hex, and string) for DHCP option codes to ensure correct configuration generation and prevent invalid payloads.
php · high confidence
Introduce custom opnsense-shell and rc syshooks
The package now installs a custom shell (/usr/local/sbin/opnsense-shell) and registers it for the root user, replacing the default /bin/csh. It also automatically hooks into /etc/rc and /etc/rc.shutdown to execute OPNsense-specific rc scripts, ensuring proper service initialization and shutdown sequencing.
(repo-wide) · high confidence
Introduce zone-based Captive Portal architecture with per-zone lighttpd and API services
The Captive Portal configuration system has been migrated from a single-instance model to a zone-based architecture, allowing multiple independent portal zones to be defined and managed. This change introduces new Jinja2 templates that generate per-zone lighttpd configurations (lighttpd-zone.conf) listening on distinct ports (zoneid + 8000/9000) with specific SSL/TLS settings, alongside a dedicated lighttpd API dispatcher (lighttpd-api-dispatcher.conf) on localhost:8999 to handle access control requests. The captiveportal.conf template now iterates over defined zones to configure authentication servers, timeouts, concurrent login limits, and allowed addresses/MACs per zone, while the rc.conf.d template enables the captive portal service only when at least one zone is active.
src/opnsense/service/templates/OPNsense/Captiveportal · high confidence
Introduction of SSO provider container interface
A new interface, ISSOContainer, has been added to the authentication library to standardize how Single Sign-On (SSO) providers are exposed. This interface defines a listProviders method that allows containers to yield multiple SSO provider objects, facilitating a structured approach for models to offer various authentication servers.
src/opnsense/mvc/app/library/OPNsense/Auth/SSOProviders · high confidence
Introduction of a dedicated Message model class for form validation
A new \Message\ class has been added to the \OPNsense\\Base\\Messages\ namespace to standardize how validation and system messages are structured. This class encapsulates the message text, the associated form field, and the message type, providing getters and setters for these properties along with a \\_\_toString\ method for easy output. This change supports the broader migration of the MVC layer to the Phalcon framework by introducing a structured data container for message handling within the base model layer.
src/opnsense/mvc/app/models/OPNsense/Base/Messages · high confidence
Introduction of the MVC Model Field Types framework
The OPNsense MVC framework introduces a new set of model field types in src/opnsense/mvc/app/models/OPNsense/Base/FieldTypes to handle configuration data binding and validation. This includes specialized types such as ArrayField for managing repeating configuration entries, BaseListField and BaseSetField for handling selection lists and comma-separated values, and specific validators for fields like AutoNumberField, Base64Field, BooleanField, CertificateField, and PortField. These components replace legacy configuration handling, providing a structured way to define, validate, and manage system settings within the new MVC architecture.
src/opnsense/mvc/app/models/OPNsense/Base/FieldTypes · high confidence
Introduction of the official OPNsense dark theme
The OPNsense web interface now includes an official dark theme, which is set as the default. This change updates the visual appearance of the UI, including font colors, contrast, and layout adjustments for components like the sidebar, dashboard, and data grids, to provide a consistent dark-mode experience across the system.
src/opnsense/www/themes/opnsense-dark/assets · high confidence · unverified
Intrusion Detection System model initialization
The Intrusion Detection System (IDS) configuration model has been initialized with a new XML schema and PHP backend class. This establishes the data structure for managing IDS rules, policies, and user-defined rules, including support for SSL fingerprinting, bypass actions, and capture modes (PCAP, Netmap, Divert).
src/opnsense/mvc/app/models/OPNsense/IDS · high confidence
Migrate User, Group, and Privilege management to MVC/API controllers
The System Access management for Users, Groups, and Privileges has been migrated from the legacy codebase to new MVC/API controllers (UserController, GroupController, PrivController). This change introduces API-driven management for these entities, including support for CSV export/import of users, automatic synchronization of group memberships when users are modified, and the generation of TOTP URIs for two-factor authentication. It also enforces safety checks to prevent users from locking themselves out of the system and ensures audit messages are recorded for all access-related changes.
src/opnsense/mvc/app/controllers/OPNsense/Auth/Api · high confidence
Monit service management and status monitoring API
This change introduces the API controllers for the Monit service integration, enabling users to configure and monitor system services. The ServiceController provides endpoints to check configuration validity and reconfigure the Monit daemon, while the SettingsController exposes CRUD operations for managing alerts, services, and tests. Additionally, the StatusController fetches real-time status from the Monit HTTPD socket, converting raw text output into styled HTML for the dashboard and returning structured XML for programmatic access.
src/opnsense/mvc/app/controllers/OPNsense/Monit/Api · high confidence
New API controllers for IDS service and settings management
Added ServiceController and SettingsController to the IDS API, introducing endpoints to manage the Intrusion Detection Service lifecycle and configuration. The ServiceController provides actions to reconfigure the service (including automatic cron job creation), update rules, reload the Suricata ruleset, and query alerts with search and pagination support. The SettingsController exposes methods to search installed rules with metadata filtering, retrieve detailed rule information with clickable CVE/URL references, and list available rule metadata, enabling the frontend to manage IDS settings and rule adjustments via the API.
src/opnsense/mvc/app/controllers/OPNsense/IDS/Api · high confidence
New API controllers for gateway status and route management
Added two new API controllers to the Routes module: GatewayController exposes a new gateway status endpoint (api/routes/gateway/status) that returns current gateway states via the backend, and RoutesController provides the API surface for managing static routes (search, add, get, delete, toggle, and reconfigure). The RoutesController implements logic to defer deletion of routes until the configuration is applied, ensuring that changes to a route's network address or deletion of a route are persisted to a temporary file and processed during the apply phase.
src/opnsense/mvc/app/controllers/OPNsense/Routes/Api · high confidence
New CLI scripts for model migrations and validation
Added three new executable scripts in the MVC script directory to manage model lifecycle tasks. \run\_migrations.php\ allows administrators to execute database migrations for models, supporting verbose logging and targeted execution by class prefix, while ensuring configuration changes are persisted only when migrations occur. \run\_validations.php\ provides a way to validate model definitions and output any constraint violations. \load\_phalcon.php\ serves as the centralized bootstrap script for loading the Phalcon framework and application configuration, replacing scattered initialization logic in legacy scripts.
src/opnsense/mvc/script · high confidence
New CLI scripts for user and group synchronization and listing
Added four new PHP scripts in the auth directory to manage local system accounts based on the OPNsense configuration: \add\_user.php\ creates a new user with a random password; \sync\_user.php\ and \sync\_group.php\ synchronize local user and group accounts with the configuration database, handling additions, updates, and deletions; and \list\_group\_members.php\ outputs group membership as JSON. These scripts provide the backend mechanism for managing local authentication entities via command-line interfaces.
src/opnsense/scripts/auth · high confidence
New Captive Portal API controllers for access, sessions, vouchers, and templates
This change introduces a suite of new API controllers in the Captive Portal module, providing programmatic access to core captive portal functions. The AccessController implements the RFC 8908 status endpoint and handles client authentication checks, including anonymous login when no auth servers are configured and MAC address retrieval via the hostwatch service. The SessionController exposes endpoints to list, search, connect, and disconnect client sessions, as well as retrieve available zones. The VoucherController adds API actions to list voucher groups, generate, expire, and drop vouchers, and manage voucher groups. The TemplateController allows administrators to search, download, and save captive portal web templates, including logic to strip unchanged files to keep configuration size minimal. Finally, the ServiceController ensures the IPFW firewall rules are reloaded when the captive portal service is reconfigured, and the SettingsController provides standard CRUD operations for captive portal zone settings.
src/opnsense/mvc/app/controllers/OPNsense/CaptivePortal/Api · high confidence
New Cron API controllers for job management and service restart
Added ServiceController and SettingsController to the Cron API. The SettingsController exposes actions to retrieve, add, update, delete, toggle, and search cron jobs, including validation that prevents modification of commands/parameters for jobs created by other services and restricts deletion of automatically registered jobs. The ServiceController provides an action to restart the cron daemon via configd.
src/opnsense/mvc/app/controllers/OPNsense/Cron/Api · high confidence
New Cron job management controllers
Added IndexController and ItemController to the Cron module, enabling the web interface to display the main cron job list and open individual job editing forms. The ItemController specifically handles opening a single job by UUID, including input sanitization for the selected item identifier.
src/opnsense/mvc/app/controllers/OPNsense/Cron · high confidence
New DHC Relay API endpoints for managing relays and destinations
The DHC Relay configuration interface now exposes dedicated API controllers to manage relay entries and destination servers. Users can search, add, edit, delete, and toggle the enabled state of individual relays (including fields like interface, destination, circuit\_id, and remote\_id) and manage destination server definitions via the new SettingsController. Additionally, a ServiceController provides an endpoint to reconfigure and restart the dhcrelay service, allowing users to apply changes through the GUI.
src/opnsense/mvc/app/controllers/OPNsense/DHCRelay/Api · high confidence
New DHCPD lease file watcher
A new Python module has been added to monitor the DHCP lease file (/var/dhcpd/var/db/dhcpd.leases). This watcher parses lease entries, handling file rotation by detecting inode changes, and extracts key details such as IP address, MAC address, hostname, and binding state. It specifically handles edge cases like empty sections and malformed date formats to ensure robust parsing of lease data.
src/opnsense/site-python/watchers · high confidence
New Dnsmasq Leases view with filtering and reservation management
A new Leases tab has been added to the Dnsmasq service settings, providing a grid view of active DHCP and Router Advertisement leases. Users can filter the lease list by specific network interfaces and IP protocol version (IPv4/IPv6). The view displays detailed client information, including IP address, MAC address, IAID, DUID, expiration time, and hostname, while distinguishing between static and dynamic lease types. For each entry, users can either search for an existing reservation or directly add a new static reservation, with the system automatically populating the reservation form with the lease's relevant identifiers.
src/opnsense/mvc/app/views/OPNsense/Dnsmasq · high confidence
New Host Discovery Settings Controller
A new SettingsController has been added for the Hostdiscovery module, enabling the configuration interface for automatic neighbor discovery. This controller initializes the settings view and includes the moment.js library to support consistent datetime formatting in the user interface.
src/opnsense/mvc/app/controllers/OPNsense/Hostdiscovery · high confidence
New Hostdiscovery settings page with discovered hosts grid
A new settings view for the Hostdiscovery feature has been added, providing a tabbed interface for general configuration and a 'Discovered Hosts' tab. The hosts grid displays interface, IP address, MAC address, organization, and last seen time (formatted as ISO datetime), with the list sorted by last\_seen in descending order by default. The page includes a reconfigure action button to apply service changes.
src/opnsense/mvc/app/views/OPNsense/Hostdiscovery · high confidence
New Hostwatch model for configurable host discovery
A new Hostwatch model has been added to the Hostdiscovery module, introducing a configuration interface for host discovery. This model exposes settings to enable the feature, toggle promiscuous mode (defaulting to disabled), enable verbose logging, define networks to skip, set expiration intervals for IPv4 and IPv6 entries (minimum 3600 seconds), and select specific interfaces for monitoring.
src/opnsense/mvc/app/models/OPNsense/Hostdiscovery · high confidence
New IDS policy editor and alert log viewer
The Intrusion Detection System interface now includes a dedicated Policy tab for managing rule adjustments and a new alert log viewer that allows users to select and switch between available log files. The policy editor supports bulk rule action changes and integrates with the metadata system for filtering, while the alert viewer provides a dropdown to choose specific log sequences for inspection.
src/opnsense/mvc/app/views/OPNsense/IDS · high confidence
New IPsec MVC views for connections, sessions, and key management
The IPsec interface now includes new MVC view templates for managing connections, sessions, key pairs, pre-shared keys, and security policies. These views replace legacy PHP templates with a modern grid-based UI, enabling users to configure IPsec tunnels, view active sessions, generate and manage key pairs, and manage security policy databases directly from the web interface.
src/opnsense/mvc/app/views/OPNsense/IPsec · high confidence
New Kea DHCP management scripts for lease control, status, and prefix delegation
This change introduces a new set of Python scripts in src/opnsense/scripts/kea to manage the Kea DHCP server. The new \del\_kea\_leases.py\ script allows users to delete specific IPv4 and IPv6 leases via the control socket, while \get\_kea\_leases.py\ provides detailed lease status information, including the ability to identify which leases are backed by reservations. Additionally, \kea\_prefix\_watcher.py\ and \kea\_prefix\_renew.py\ handle dynamic IPv6 prefix delegation by monitoring leases and installing corresponding system routes, and \kea\_dhcp\_options.py\ exposes IANA DHCP option definitions. These scripts rely on a new \lib/kea\_ctrl.py\ module to communicate with the Kea control sockets.
src/opnsense/scripts/kea · high confidence
New Kea DHCP management views for control agent, DDNS, DHCPv4/v6 configuration, and lease grids
This change introduces the user interface views for the new Kea DHCP service in OPNsense. It adds dedicated pages for managing the Kea control agent and DDNS settings, as well as full configuration interfaces for DHCPv4 and DHCPv6 (including subnets, reservations, options, and HA peers). The DHCPv4 view supports CSV import/export for reservations and manual configuration modes, while the DHCPv6 view adds support for dynamic prefix delegation. Additionally, new lease management grids for both IPv4 and IPv6 allow administrators to view active leases, filter by interface, delete leases, and quickly add or find reservations.
src/opnsense/mvc/app/views/OPNsense/Kea · high confidence
New MVC API controllers for Firewall, Aliases, Categories, and NAT
The firewall management interface has been migrated to a new Model-View-Controller (MVC) architecture, introducing a suite of new API controllers in the \src/opnsense/mvc/app/controllers/OPNsense/Firewall/Api\ directory. This change replaces legacy PHP-based endpoints with structured controllers for Firewall Rules (\FilterController\), Destination NAT (\DNatController\), Source NAT, One-to-One NAT, Network Prefix Translation (\NptController\), Aliases (\AliasController\, \AliasUtilController\), Categories (\CategoryController\), and Interface Groups (\GroupController\). A shared \FilterBaseController\ provides common logic for category handling, network alias metadata, and legacy rule compatibility. Additionally, a \MigrationController\ is introduced to assist users in exporting legacy rules and outbound NAT configurations during the transition. This architectural shift standardizes the API layer, improves code maintainability, and enables new features like category-based filtering and color-coded rule organization.
src/opnsense/mvc/app/controllers/OPNsense/Firewall/Api · high confidence
New MVC API controllers for IPsec management
The IPsec subsystem now exposes a comprehensive set of new API controllers (Connections, KeyPairs, Leases, ManualSpd, Pools, PreSharedKeys, Sad, Service, Sessions, Settings, Spd, Tunnel, and Vti) that replace legacy subsystem handling with a modern MVC architecture. These controllers provide standardized CRUD endpoints for managing IPsec connections, key pairs, security policies, and tunnel interfaces, while also exposing real-time status data for sessions, security association databases (SAD), and security policy databases (SPD) via backend commands. The ServiceController handles IPsec service lifecycle and interface registration, and the LegacySubsystemController maintains backward compatibility for dirty-state tracking and configuration application during the migration period.
src/opnsense/mvc/app/controllers/OPNsense/IPsec/Api · high confidence
New MVC API controllers for system diagnostics
The Diagnostics API now includes a set of new MVC controllers (Activity, CpuUsage, Dns, DnsDiagnostics, Firewall, Interface, Log, Lvtemplate, Netflow, Networkinsight, PacketCapture, Ping) that expose diagnostic capabilities via structured API endpoints. These controllers provide programmatic access to system activity and CPU metrics, DNS reverse lookups and query diagnostics, firewall log retrieval and filtering, interface ARP/NDP/route table management, centralized log viewing and export, Netflow configuration and statistics, network insight timeseries data, packet capture job management, and ping job control, replacing or supplementing previous legacy implementations with a consistent MVC-based API layer.
src/opnsense/mvc/app/controllers/OPNsense/Diagnostics/Api · high confidence
New MVC core library components for configuration and backend communication
The MVC application layer now includes a set of core library classes in \OPNsense\\Core\ to handle system configuration, backend communication, and file management. The \Config\ class provides a new SimpleXML-based interface for reading and writing the system configuration XML, including methods to convert between XML and array structures. The \Backend\ class manages communication with the \configd\ daemon via Unix sockets, supporting both synchronous and streaming responses. File operations are now handled by \File\ and \FileObject\ classes, which enforce specific permissions and ownership when writing configuration files. Additionally, \ConfigMaintenance\ offers utilities for managing configuration models and legacy paths, while \Shell\ and \SanitizeFilter\ provide safe command execution and input sanitization.
src/opnsense/mvc/app/library/OPNsense/Core · high confidence
New MVC default layout with enhanced UI and security features
The default MVC layout template has been introduced, establishing a unified base for the new interface. This change adds a Favorites section to the navigation menu and implements a live search feature that allows users to quickly navigate to menu items. Security is improved by automatically attaching CSRF tokens to all jQuery AJAX requests. The user experience is refined with a global error handling system that displays API errors in a non-intrusive dialog (excluding specific upgrade status endpoints), collapsible table headers for better data density, and logic to automatically hide empty menu items. Additionally, the layout supports theme-based CSS/JS loading and includes meta tags to prevent search engine indexing.
src/opnsense/mvc/app/views/layouts · high confidence
New MVC field types for authentication and user management
Added a suite of new model field types in the Auth module to support the migration of Users and Groups to the MVC/API architecture. These include ApiKeyField for managing API credentials, ExpiresField for handling expiration dates with flexible input formats, GidField and UidField for automatic ID generation and validation, GroupMembershipField and MemberField for managing group and user associations, PrivField for privilege selection, StoreB64Field for secure base64 storage, and UsernameField which now supports longer usernames and email addresses for non-local users without shell accounts.
src/opnsense/mvc/app/models/OPNsense/Auth/FieldTypes · high confidence
New MVC field types for interface configuration
The interface configuration UI now uses a comprehensive set of new MVC model field types to handle specific data entry and validation. These include BridgeMemberField for selecting bridge members, DUIDField for validating DHCPv6 identifiers, DeviceField for populating device lists with icons, and GatewayField for selecting gateways by protocol. DHCP options are now validated via Dhcp4/6RequestOptionsField and Dhcp4/6SendOptionsField, while LinkAddressField manages interface and virtual IP address selection. Additional fields like IfDescField, LaggInterfaceField, MediaTypesField, NeighborField, NetworkInterfaceField, and VipField provide structured handling for interface descriptions, LAGG parents, media options, ARP/NDP neighbors, full network interface settings, and virtual IP configurations respectively.
src/opnsense/mvc/app/models/OPNsense/Interfaces/FieldTypes · high confidence
New MVC firewall rule engine classes
The firewall library now includes a new set of MVC-based rule classes (FilterRule, ForwardRule, DNatRule, SNatRule, NptRule, Rule, Plugin, and Util) that replace legacy parsing logic. These classes handle the parsing and rendering of firewall filter, port forward, destination NAT, source NAT, and NPT rules, including support for reflection, gateway mapping, and alias resolution, providing a more structured and maintainable approach to firewall rule generation.
src/opnsense/mvc/app/library/OPNsense/Firewall · high confidence
New MVC views for core system pages
The system introduces new MVC view templates for several core pages, including the dashboard, firmware, backup history, configuration defaults, high availability sync, initial setup wizard, license, reboot, halt, and service management. These views replace legacy implementations with a modern structure, featuring API-driven data loading, responsive layouts, and standardized UI components like Bootgrid tables and Bootstrap dialogs.
src/opnsense/mvc/app/views/OPNsense/Core · high confidence
New MVC-based diagnostic views for ARP, DNS, firewall logs, states, and system health
The Diagnostics section now features new MVC view templates (arp, dns\_diagnostics, fw\_log, fw\_pftop, fw\_states, fw\_stats, health, log, ndp) that replace legacy PHP pages. These views provide a consistent interface for managing ARP/NDP tables, performing DNS queries, viewing and filtering firewall logs with a ring buffer, managing firewall states and sessions, and monitoring system health with RRD graphs.
src/opnsense/mvc/app/views/OPNsense/Diagnostics · high confidence
New NetFlow data aggregation engine for interface, port, and source statistics
The NetFlow reporting system now uses a new modular aggregation framework located in \src/opnsense/scripts/netflow/lib/aggregates\. This introduces a \BaseFlowAggregator\ that stores time-series data in SQLite databases with configurable sample resolutions (e.g., 30s, 5m, 1h, 1d) and automatic data expiration. Specific aggregators have been added to provide new insights: \FlowInterfaceTotals\ tracks interface traffic split by direction (in/out); \FlowDstPortTotals\ aggregates traffic by destination port, protocol, and interface; \FlowSourceAddrTotals\ tracks source addresses with direction; and \FlowSourceAddrDetails\ provides daily-resolution statistics on source/destination pairs, services, and protocols, retaining data for up to 62 days. This replaces previous aggregation logic with a more structured, extensible approach for Network Insight.
src/opnsense/scripts/netflow/lib/aggregates · high confidence
New OpenVPN client export formats and options
The OpenVPN client export feature now supports additional output formats, including a ZIP archive and the Viscosity (visz) format, alongside the existing plain file export. This update also introduces new configuration options for client exports: support for tls-crypt-v2, the ability to use Windows Certificate Store (cryptoapi) instead of embedded certificates, static challenge (OTP) support, and the auth-nocache directive. These changes provide greater flexibility for different client environments and security requirements.
src/opnsense/mvc/app/library/OPNsense/OpenVPN · high confidence
New Python helper modules for logging, database, and TLS
This change introduces several new Python helper modules in the site-python directory. The log\_helper module provides a reverse log reader that supports both file paths and stream inputs, with fixes for off-by-one errors and garbled data handling. A new duckdb\_helper module enables database export/import functionality and manages concurrent read/write access with file locking. The sqlite3\_helper module adds integrity checking and automatic repair capabilities for SQLite databases. Additionally, a tls\_helper module wraps the requests library to apply platform TLS settings from openssl.cnf, and a daemonize module provides process daemonization utilities.
src/opnsense/site-python · high confidence
New Routes Index Controller for OPNsense MVC
A new IndexController has been added for the Routes module, establishing the entry point for the static routes management interface. This controller initializes the view with the necessary form definitions for editing routes and sets up the grid display, enabling users to view and manage static route configurations through the web interface.
src/opnsense/mvc/app/controllers/OPNsense/Routes · high confidence
New SPDX 3 SBOM generator tool in contrib/spdx-sbom
A new Python-based utility has been added to the contrib/spdx-sbom directory that generates SPDX 3 formatted Software Bill of Materials (SBOM) files. The tool, invoked via \spdx-generator.py \<package-name\>\, queries the local \pkg\ database to retrieve package metadata (such as version, license, and dependencies) and constructs a JSON-LD SBOM document. This allows users to produce standardized compliance artifacts for specific installed packages.
contrib/spdx-sbom · high confidence
New Syslog Index Controller for Logging Settings
The Syslog module now includes a dedicated IndexController that serves the main logging interface. This controller initializes the local settings form and the destination management dialogs (both the edit dialog and the grid view), enabling users to configure local logging options and manage remote syslog destinations through the web UI.
src/opnsense/mvc/app/controllers/OPNsense/Syslog · high confidence
New System Trust management pages and API endpoints
This change introduces the initial user interface and API controllers for the new System Trust module, enabling administrators to manage Certificate Authorities, Certificates, and Certificate Revocation Lists (CRLs) directly from the web interface. The new \CaController\, \CertController\, and \CrlController\ classes provide the backend API endpoints for creating, importing, and linking trust objects, while the corresponding \SettingsController\ allows configuration of trust services. This establishes the foundation for the Trust management feature, allowing users to view and edit certificate authorities and their associated revocation lists.
src/opnsense/mvc/app/controllers/OPNsense/Trust/Api · high confidence
New Traffic Shaper API endpoints for service management and settings
This change introduces new API controllers for the Traffic Shaper feature. The ServiceController adds endpoints to reload the shaper and IPFW configurations, flush all IPFW rules, and retrieve detailed traffic statistics (pipes, queues, and rules) with linked descriptions. The SettingsController exposes standard CRUD operations (get, set, add, delete, toggle, search) for traffic shaper pipes and queues, enabling programmatic management of these shaping components.
src/opnsense/mvc/app/controllers/OPNsense/TrafficShaper/Api · high confidence
New Traffic Shaper statistics view with live flow monitoring
The Traffic Shaper interface now includes a dedicated Statistics tab that provides a real-time breakdown of traffic activity for pipes, queues, and rules. This view displays total packet and byte counts, last access times, and expands to show active network flows (protocol, source, destination, and transfer volumes) for each node. It also visualizes the percentage of traffic handled by individual queues within a pipe, giving administrators immediate visibility into how shaping rules are performing.
src/opnsense/mvc/app/views/OPNsense/TrafficShaper · high confidence
New Trust Store abstraction layer for certificate management
The system introduces a new \OPNsense\\Trust\\Store\ class that acts as a wrapper around the legacy trust store functionality. This change centralizes certificate operations, providing methods to retrieve CA and user certificates with parsed details (such as purpose detection and subject/issuer mapping), sign certificates using CAs or self-signing, and generate secure OpenSSL configuration options via temporary files. This refactoring improves code reusability and prepares the foundation for more robust certificate handling in the UI and backend services.
src/opnsense/mvc/app/library/OPNsense/Trust · high confidence
New Trust management models and migration logic
This change introduces the foundational data models for the new Trust management system, including \Ca.xml\ and \Cert.xml\ which define the schema for Certificate Authorities and Certificates (supporting key types up to RSA-7680 and various elliptic curves), and \General.xml\ which defines global trust settings like minimum protocol versions and cipher suites. The \Cert.php\ model adds logic to automatically link certificates to their issuing CAs based on subject/issuer matching, while \General.php\ enforces validation that config constraints cannot be enabled without specific cipher or protocol options set. Additionally, migration scripts (\M1\_0\_0.php\, \M1\_0\_2.php\) are included to handle legacy configuration imports and to automatically correct faulty DTLSv1.1 settings to DTLSv1.2.
src/opnsense/mvc/app/models/OPNsense/Trust · high confidence
New Trust management views for CAs, Certificates, CRLs, and Settings
The System: Trust interface now includes dedicated MVC view templates (ca.volt, cert.volt, crl.volt, settings.volt) that provide the user-facing UI for managing trust infrastructure. These views implement Bootgrid-based tables for browsing and filtering Certificate Authorities, Certificates, and Certificate Revocation Lists, featuring specific actions such as viewing raw certificate info, downloading files (including PKCS\#12 exports for certificates), and managing CRLs. The settings view adds a configuration form with an apply button to manage trust-related system settings, while the certificate view introduces user and CA filtering capabilities to help users locate specific certificates.
src/opnsense/mvc/app/views/OPNsense/Trust · high confidence
New and updated validation constraints for model fields
The MVC validation layer in src/opnsense/mvc/app/models/OPNsense/Base/Constraints now includes several new constraint types to enforce more complex field relationships: AllOrNoneConstraint ensures that a group of sibling fields are either all empty or all populated; DependConstraint requires that referenced fields are also empty when the current field is empty; SetConstraint requires that referenced fields are unset when the current field is unset; SetIfConstraint mandates that a field is set if another field matches a specific value; ComparedToFieldConstraint validates numeric relationships (greater than, less than, equal, etc.) between two fields; and SingleSelectConstraint ensures only one option in a group is selected. Additionally, UniqueConstraint has been enhanced to support case-insensitive uniqueness checks and to validate uniqueness across added fields within array-type nodes.
src/opnsense/mvc/app/models/OPNsense/Base/Constraints · high confidence
New boot-time service scripts for crash dumps, live mode, PHP, recovery, swap, and tmp/var management
The system now includes a set of new rc.subr.d scripts (crashdump, livemode, php, recover, swapon, tmp, and var) that handle critical boot-time initialization. The crashdump script configures kernel crash dumps and copies debug symbols. The livemode script manages the installer user account for live media boots. The php script ensures the correct ownership and permissions for PHP directories and flushes cached templates. The recover script provides a robust mechanism to restore essential system files (like /etc/passwd, /etc/shells, and /etc/ttys) from embedded defaults if they are missing or corrupted. The swapon script handles the creation and activation of a swap file on SSDs if configured. The tmp and var scripts manage the creation, cleaning, and optional mounting of tmpfs for /tmp and /var/log, respecting user-configurable memory limits and ensuring proper permissions for services like PHP and DHCP.
src/etc/rc.subr.d · high confidence
New console shell menu scripts for system management
The console shell menu now includes dedicated scripts for managing the firewall: banner.php displays network interface addresses and SSH/HTTPS fingerprints; firmware.sh handles update and upgrade workflows; defaults.php, halt.php, reboot.php, and password.php allow factory resets, power control, and root password changes; ping.php provides network diagnostics; restore.sh enables reviewing and applying configuration backups; setaddr.php and setports.php assist in configuring interface addresses and physical ports.
src/opnsense/scripts/shell · high confidence
New console utilities and service status monitoring
The system now includes several new command-line tools in /usr/sbin to improve console management and reliability. The new opnsense-shell replaces the previous rc.initital menu, offering a modernized interface for tasks like setting IP addresses, managing firmware, and restoring backups. A new opnsense-crypt utility allows administrators to encrypt or decrypt configuration files using a secret key, enhancing security for backups. Additionally, a new carp\_service\_status script automatically monitors service health and demotes CARP interfaces if critical services fail, helping to prevent split-brain scenarios in high-availability setups. Other new tools include opnsense-log for easier log access, opnsense-beep for console audio feedback, and pluginctl enhancements for configuration management.
src/sbin · high confidence
New core API controllers for system management
This change introduces a suite of new API controllers in the Core module to manage system configuration and state. The BackupController provides endpoints to list, diff, delete, revert, and download configuration backups. The DashboardController manages user-specific dashboard layouts, including saving widget configurations and restoring defaults. The DefaultsController allows retrieving factory default settings and resetting specific configuration sections. The FirmwareController handles firmware update checks, status retrieval, and package management. The HasyncController and HasyncStatusController manage high-availability synchronization and remote service control. The InitialSetupController handles the initial system setup wizard. The MenuController provides user-context-sensitive menu trees and search. The ServiceController allows starting, stopping, and restarting system services. The SnapshotsController manages ZFS boot environment snapshots, including creation, renaming, and note storage. Finally, the SystemController handles system halt, reboot, and status reporting.
src/opnsense/mvc/app/controllers/OPNsense/Core/Api · high confidence
New dashboard widgets and base widget framework
The dashboard now includes several new widgets: Announcements (fetches and displays product info feed items), Certificates (lists CAs and certificates sorted by expiration with configurable hidden items), CARP (displays VIP status and aliases), CPU (shows usage graphs for total, interrupt, user, and system with configurable graph selection), Disk (displays used/free space via gauge and detailed per-mountpoint bar chart, switching views based on widget width), Dnsmasq Leases (shows recent DHCP leases with a usage gauge and configurable limit), and Firewall (displays firewall rule match counts with color-coded actions and a traffic chart). These widgets rely on a new base widget framework (BaseWidget, BaseTableWidget, BaseGaugeWidget) that provides common functionality like AJAX calls with retry mechanisms, event source handling, widget configuration options, and table/gauge rendering utilities.
src/opnsense/www/js/widgets · high confidence
New development and linting scripts for code quality and dashboard ACLs
Added several new shell and Perl scripts to the Scripts directory to improve code quality checks and development workflows. The new \dashboard-acl.sh\ script validates that JavaScript dashboard widgets have matching ACL definitions and registered endpoints, ensuring security consistency. \class-filename.sh\ and \class-import.sh\ enforce PHP coding standards by verifying that class names match filenames and that imports are actually used. Additional utilities include \unused-functions.sh\ for detecting dead code, \cleanfile\ for normalizing whitespace, \license\ for generating copyright headers, and \version.sh\ for deriving version information from Git.
Scripts · high confidence
New dnsmasq helper scripts for DHCP options and lease management
Added three new Python scripts to the dnsmasq directory: \dnsmasq\_dhcp\_options.py\ generates a JSON list of DHCP options from IANA registries and dnsmasq's help output; \dnsmasq\_watcher.py\ monitors DHCPD lease files to automatically update dnsmasq's dynamic host entries; and \get\_dnsmasq\_leases.py\ retrieves current dnsmasq lease records in JSON format, including MAC/IAID extraction for IPv6 clients.
src/opnsense/scripts/dnsmasq · high confidence
New field types for Diagnostics Packet Capture configuration
Added HostField and InterfaceField model components to support the new Packet Capture diagnostics feature. HostField introduces validation logic that allows users to specify host addresses using IP addresses, subnets, and MAC addresses, combined with logical operators (and, or, not). InterfaceField provides a dynamic list of available network interfaces, displaying both the interface name and its description for easier selection in the diagnostics UI.
src/opnsense/mvc/app/models/OPNsense/Diagnostics/FieldTypes · high confidence
New firewall diagnostics library for state and session analysis
Added a new Python library in src/opnsense/scripts/filter/lib to support the Firewall Diagnostics interface. This includes an asynchronous DNS resolver for efficient hostname lookups and a state parser that extracts detailed information from pfctl output, such as rule labels, gateways, and network addresses. The library also provides utilities for parsing wildcard netmasks and filtering states by multiple network clauses, enabling the new Sessions and States diagnostic pages to display richer, more accurate data about active firewall connections.
src/opnsense/scripts/filter/lib · high confidence
New firewall field types for alias validation, dynamic alias stats, and rule sequencing
This change introduces several new model field types in the firewall configuration to improve alias handling and rule management. AliasContentField provides unified validation for alias content types (ports, ASNs, hosts, etc.), while AliasField now dynamically loads alias definitions and displays real-time table statistics (item counts, last updated) in the UI. AliasNameField enforces stricter naming rules by blocking reserved pf keywords and ensuring names don't start or end with digits. Additionally, FilterSequenceField and DNatSequenceField implement a new auto-numbering strategy that appends new rules at the end of the sequence (incrementing by 100) rather than filling gaps, and GroupField adds predefined entries for OpenVPN, IPsec, and WireGuard interfaces.
src/opnsense/mvc/app/models/OPNsense/Firewall/FieldTypes · high confidence
New firewall rule lookup redirector
A new \firewall\_rule\_lookup.php\ page has been added to the web GUI. It handles redirects from firewall rules (such as those in live logs) by resolving rule references to the correct interface and rule ID, or by searching for a rule by its hash. This allows users to navigate directly to the specific rule that triggered an event.
src/www · high confidence
New interface management and diagnostics scripts
This update introduces a suite of new backend scripts in src/opnsense/scripts/interfaces to modernize interface configuration and diagnostics. A new apply\_pending\_if\_changes.php script enables batched, pending interface changes via a todo file, while capture.py replaces the legacy packet capture tool with a Python-based implementation supporting netmap and detailed filtering. CARP management is now handled by carp\_global\_status.php and carp\_set\_status.php for maintenance and enable/disable actions. DHCPv4 and DHCPv6 client interactions are standardized through new dhclient-script and dhcp6c\_script.sh files that delegate route and nameserver management to ifctl. Additional utilities include gen\_duid.php for generating DUIDs, ifctl.sh for low-level interface control, and various list scripts (list\_arp.py, list\_ndp.py, list\_hosts.py, list\_macdb.py, list\_mediaopts.php, list\_regdomain.py, list\_sockstat.py) to provide structured data for ARP/NDP tables, host discovery, MAC vendors, and network statistics.
src/opnsense/scripts/interfaces · high confidence
New manual pages for system utilities
Added manual pages for several core system utilities, including configctl, ifctl, opnsense-beep, opnsense-crypt, opnsense-importer, opnsense-installer, opnsense-log, opnsense-shell, and opnsense-version. These pages document the available command-line options, usage modes, and file locations for each tool, improving discoverability and clarity for administrators.
src/man · high confidence
New physical\_interface macro for interface resolution
A new shared macro named physical\_interface has been added to the OPNsense template system. This macro resolves a logical interface name (such as 'lan') to its corresponding physical interface name (such as 'em0') by querying the system's interface configuration. If the logical interface is not found in the configuration, the macro safely returns the original name provided, ensuring templates do not fail when dealing with unknown or unconfigured interfaces.
src/opnsense/service/templates/OPNsense/Macros · high confidence
New pluggable authentication framework with API key support
The authentication library has been refactored into a modular, pluggable framework centered around the new AuthenticationFactory and IAuthConnector interface. This change introduces a dedicated API authenticator (src/opnsense/mvc/app/library/OPNsense/Auth/API.php) that allows users to authenticate against local API keys stored in the configuration, enabling programmatic access. The framework also standardizes support for existing methods—including Local, LDAP, RADIUS, and TOTP—under a unified interface, allowing for consistent service binding and extensibility.
src/opnsense/mvc/app/library/OPNsense/Auth · high confidence
New routing and gateway management scripts
The system now includes a set of new Python and PHP scripts in src/opnsense/scripts/routes to handle routing table operations and gateway monitoring. show\_routes.py displays the current IPv4/IPv6 routing table, while del\_route.py allows for the manual deletion of static routes by destination and gateway. Gateway management is handled by gateways.php (listing gateways and groups), gateway\_status.php (providing JSON status details like loss and delay for the dashboard), and gateway\_watcher.php (continuously monitoring gateway health, caching status, and triggering configuration reloads on state changes).
src/opnsense/scripts/routes · high confidence
New shaper statistics parsing library
Added a new Python library at src/opnsense/scripts/shaper/lib/\_\init\\_.py that parses traffic shaper statistics from dnctl and ipfw commands. This library provides functions to parse IPFW pipes, queues, schedulers, and rules, enabling the collection of detailed traffic shaping metrics for API endpoints and UI overviews.
src/opnsense/scripts/shaper/lib · high confidence
New syslog log format parsers for Service Logs and RFC 5424
Added new log format handlers in the syslog parsing module to support additional log structures. This includes a ServiceLogFormat parser that recognizes timestamps with timezone offsets (e.g., +00:00), addressing issues with timezones west of UTC, and a SysLogFormatRFC5424 parser for RFC 5424 compliant syslog messages, which extracts structured fields like facility, severity, and process name. These changes enable the system to correctly parse and display entries from service logs collected during the current boot, improving visibility into system health and service activity.
src/opnsense/scripts/syslog/logformats · high confidence
New system administration and monitoring scripts
This update introduces a suite of new backend scripts in src/opnsense/scripts/system to enhance system management and observability. Users gain access to boot environment management via bectl.py (supporting create, clone, activate, and destroy operations on ZFS), CPU usage streaming through cpu.py, and detailed disk usage reporting via disk\_info.py. Certificate management is expanded with certctl.py (a Python-based trust store re-implementation), crl\_fetch.py (automatic CRL distribution point downloading), and cert\_fetch\_local.py (support for locally managed certificates). Additional utilities include activity.py for process monitoring, ha\_xmlrpc\_exec.php for high-availability service control, and remote\_backup.php which now supports an optional random delay for scheduled backups.
src/opnsense/scripts/system · high confidence
New template helper functions for configuration rendering
The addons module now includes a dedicated template helper module (template\_helpers.py) that provides new utility functions for configuration templates. These helpers allow templates to safely check for the existence or emptiness of configuration nodes (exists, empty), ensure list consistency (toList), resolve UUIDs to tags and vice versa, and map interface technical names to physical device names (physical\_interface, physical\_interfaces). Additionally, new helpers simplify formatting host and port strings, automatically handling IPv6 bracketing (host\_for\_port, host\_with\_port).
src/opnsense/service/modules/addons · high confidence
SSH algorithm query utility added
A new Python script (ssh\_query.py) has been added to the OpenSSH scripts directory. This utility queries the local SSH client for supported key exchange, MAC, cipher, key, and key-signature algorithms and outputs the results as JSON. This tool supports the GUI's ability to configure advanced SSH options like PubkeyAcceptedAlgorithms, KexAlgorithms, Ciphers, and MACs by providing a standardized way to discover available algorithms.
src/opnsense/scripts/openssh · high confidence
Syslog API controllers for service management and destination settings
New API controllers have been added to the Syslog module to expose service and configuration management capabilities. The ServiceController introduces a reset action to clear local logging and a stats action that retrieves syslog-ng statistics, including pagination, sorting, and search filtering for log records. The SettingsController provides standard CRUD operations (create, read, update, delete, toggle) for syslog-ng destinations, allowing users to manage remote logging targets via the API.
src/opnsense/mvc/app/controllers/OPNsense/Syslog/Api · high confidence
Unbound DNS blocklist testing and module integration
The Unbound DNS service now includes a new command-line tool (dnsbl\_match.py) for testing blocklist policies against specific domains and a dedicated module (dnsbl\_module.py) that intercepts DNS queries to apply those blocklist rules. This allows administrators to verify blocklist configurations and enables the Unbound resolver to actively block queries matching defined blocklist policies.
src/opnsense/scripts/unbound-dnsbl · high confidence
User-configurable lighttpd module directory for webgui
A new conf.d directory has been added to the lighttpd webgui configuration, allowing users to enable and customize additional lighttpd modules (such as mod\_extforward for handling reverse proxy headers) by placing .conf files in this location. An example configuration for extforward is provided to demonstrate how to specify trusted proxy IPs and headers for accurate client IP logging.
_src/etc/lighttpd\webgui · high confidence
WireGuard tunnel management and diagnostics scripts added
New utility scripts have been introduced to the WireGuard subsystem to improve tunnel lifecycle management and operational visibility. The \wg-service-control.php\ script now handles interface creation, configuration synchronization, and route installation, including support for a debug flag that can be toggled without restarting the service. A new \reresolve-dns.py\ script automatically re-applies allowed-IPs and re-resolves endpoints for peers that have not completed a handshake recently, addressing connectivity issues when DNS changes occur. Additionally, \wg\_show.py\ provides a structured JSON output of current WireGuard interface and peer states, while \gen\_keypair.py\ offers a programmatic way to generate key pairs.
src/opnsense/scripts/wireguard · high confidence
Removals
Removal of legacy configuration files and embedded PHP libraries
The system has removed a large number of legacy configuration files and embedded PHP libraries from the etc directory. Deleted files include static configuration tables such as \ca\_countries\, \disktab\, \fbtab\, and \gettytab\, as well as system configuration files like \ddb.conf\, \devd.conf\, \host.conf\, and \hosts.allow\. Additionally, several embedded PHP libraries and include files have been removed, including \ecl.php\, \CHAP.inc\, \PEAR.inc\, \array\_intersect\_key.inc\, \auth.inc\, \authgui.inc\, \basic\_sasl\_client.inc\, and \captiveportal.inc\. This cleanup removes obsolete or redundant code and configuration data from the system.
etc · high confidence
Removal of legacy sbin utility scripts
The \athctrl.sh\ script, used for configuring IFS parameters on Atheros wireless interfaces, and the \dhclient-script\ helper, responsible for managing DHCP lease states, routing, and firewall rules, have been removed from the system. This eliminates the ability to manually set point-to-point link distances via \athctrl\ and removes the legacy shell-based logic for handling DHCP client events and state persistence.
sbin · high confidence
Removal of legacy system configuration and library files
This change removes a large set of legacy files from the system, including device hints, loader configurations, default system configuration templates, and various static data files (bogons, country lists, disk tables, terminal definitions). It also deletes several PHP library components, such as the external config loader, PEAR compatibility layers, and older authentication/IPv6 helper classes. For users, this means the system no longer ships with these deprecated configuration defaults and legacy code paths, likely as part of a cleanup or migration to a new configuration structure.
usr · high confidence
Removed temporary upgrade helper scripts
The temporary upgrade helper scripts located in the tmp directory (post\_upgrade\_command, post\_upgrade\_command.php, and pre\_upgrade\_command) have been removed. These scripts previously handled specific post-upgrade tasks such as package synchronization, serial console configuration, Git sync updates, and file cleanup during system upgrades.
tmp · high confidence
Architecture
Centralized configd action definitions moved to actions.d
The system has migrated its configd action definitions from legacy locations into a structured directory at src/opnsense/service/conf/actions.d. This change introduces individual configuration files for each subsystem (such as auth, captive portal, filter, firmware, interfaces, and system), standardizing how backend commands are registered and executed. For users, this provides a more consistent and maintainable backend architecture for service management and diagnostics without altering existing functionality.
src/opnsense/service/conf/actions.d · high confidence
Introduce pluggable service and device registration framework
The system now uses a plugin-based architecture for registering core services and network devices. New files in \src/etc/inc/plugins.inc.d\ define specific plugins for Hostwatch, IPFW (Traffic Shaper), Loopback interfaces, and Monit, while \core.inc\ centralizes the registration of foundational services like Configd, Syslog-ng, and Cron. This shift replaces the previous monolithic service management with a modular approach, allowing individual components to declare their own lifecycle hooks and configuration requirements.
src/etc/inc/plugins.inc.d · high confidence
Refactor build system into modular Makefile components
The build system in the Mk directory has been restructured into distinct, reusable modules: common.mk (cleaning targets), core.mk (installation and plist generation), defaults.mk (environment and replacement variables), git.mk (version control helpers), lint.mk (code quality checks), style.mk (coding standards), sweep.mk (automated cleanup), and version.mk (product metadata and dependencies). This modularization improves maintainability and plugin integration by separating concerns within the build process.
Mk · high confidence
Behavioural changes
1 commit (0 fixes) modifying contrib
A change to existing behaviour in contrib — 1 commit, 1 file: “netaddr / mac vendor mapping - update oui.csv, closes https://github.com/opnsense/core/pull/11220”. Also in this area: Local MAC vendor lookup data added.
contrib/ieee · medium confidence · unverified
25 commits (4 fixes) modifying src/opnsense/mvc/app/library/OPNsense/System
A change to existing behaviour in src/opnsense/mvc/app/library/OPNsense/System — 25 commits (4 fixs), 3 files: “mvc: style sweep”; “system: refactor system status mechanism, introduce persistent notifications”; “src: style sweep”; and 19 more (refs \#5922, \#11141, \#11104, \#5875).
src/opnsense/mvc/app/library/OPNsense/System · medium confidence · unverified
Add Python 3 link template
A new template file (python3.link.in) has been added to the build system to generate a symbolic link for the Python 3 executable at build time, using a placeholder for the core Python version dot.
src/bin · medium confidence
Added initial migration stubs for Captive Portal and Traffic Shaper models
New version 1.0.0 migration classes (M1\_0\_0.php) have been added for the Captive Portal and Traffic Shaper models. These empty migration stubs establish the baseline version for these components, allowing the system to track and manage future schema or configuration changes for these specific areas.
src/opnsense/mvc/app/models/OPNsense/CaptivePortal/Migrations, src/opnsense/mvc/app/models/OPNsense/TrafficShaper/Migrations · high confidence
Authentication script now returns JSON properties for supported services
The opnsense-auth script in src/libexec has been updated to parse additional authentication properties (such as framed IP addresses and groups) and return them as JSON-encoded data to the caller. This change enables the authentication framework to pass extra context back to services that require it, while explicitly excluding the 'squid' service to work around a known issue where passing these properties causes failures. For most existing services, this remains a non-breaking change as they primarily rely on the exit code.
src/libexec · high confidence
Automated firmware configuration refresh and stale file cleanup during updates
A new update hook script (10-refresh.sh) has been introduced to run during the update process. This script ensures that relevant firmware configuration files are refreshed by invoking the configure\_firmware script and automatically removes stale .pyc files from the /usr/local/opnsense directory that are not handled by the package manager.
src/etc/rc.syshook.d/update · high confidence
Automated migration of legacy firmware, HA, and tunables settings
The system now automatically migrates legacy configuration data during upgrades to ensure compatibility with the current MVC architecture. For firmware settings, old 'devel' types are mapped to 'business' and subscription details are extracted from the mirror URL, while obsolete flavour entries are cleared. High Availability (HA) settings are migrated to use a unified 'syncitems' list and the legacy 'pfsyncenabled' flag is folded into the 'pfsyncinterface' setting, with the pfsync version defaulting to 1301 for upgrades to preserve existing behavior. Additionally, legacy 'sharednet' tunables are converted into specific network tunables (disabling ARP movement logging) and the old configuration block is removed.
src/opnsense/mvc/app/models/OPNsense/Core/Migrations · high confidence
Automatic state cleanup for unreachable or lower-priority gateways
The monitor hook now includes a recovery script that actively kills existing connection states when a gateway becomes unreachable or when a higher-priority gateway becomes available. This ensures that traffic is immediately rerouted to the correct path, preventing stale connections from persisting on failed or superseded links.
src/etc/rc.syshook.d/monitor · high confidence
Bootstrap 3.4.1 stylesheets integrated into the OPNsense theme
The OPNsense web interface now uses the Bootstrap 3.4.1 stylesheet library, replacing the previous version. This update brings the standard Bootstrap 3.4.1 styling for core UI components—including alerts, buttons, forms, navigation, and grid layouts—to the OPNsense dashboard and configuration pages, ensuring consistent visual presentation and behavior across the interface.
src/opnsense/www/themes/opnsense/assets/stylesheets/bootstrap · high confidence
CARP and network interface event handling reconfigured
The devd configuration has been updated to improve network state management. A new carp.conf file now explicitly handles CARP state transitions (MASTER, BACKUP, and INIT) by invoking configctl, ensuring proper event capture for CARP interfaces. Additionally, ifnet.conf has been rewritten to ensure configd receives both LINK\_UP and LINK\_DOWN events for wired (ethernet) and wireless (802.11) devices, and it disables the legacy /etc/pccard\_ether script for non-USB devices to prevent unwanted reconfiguration.
src/etc/devd · high confidence
CARP state changes now trigger service reconfiguration for DHCP Relay, OpenVPN, PPP, and WireGuard
The CARP hook system now automatically reconfigures specific services when the node's CARP role changes (e.g., switching between MASTER and BACKUP). New hook scripts ensure that DHCP Relay instances restart if CARP tracking is enabled, PPP connections are suspended or restored based on the CARP state, and both OpenVPN and WireGuard services are reconfigured to adapt to the new high-availability status.
src/etc/rc.syshook.d/carp · high confidence
Captive Portal UI migrated to new MVC framework
The Captive Portal interface has been rewritten using the new MVC framework and standards. This change introduces new controller classes (IndexController, SessionController, VoucherController) that serve the zone management, client session overview, and voucher frontend pages respectively, replacing the previous implementation.
src/opnsense/mvc/app/controllers/OPNsense/CaptivePortal · high confidence
Captive Portal model introduces zone-based configuration and template management
The Captive Portal model has been restructured to support a zone-based architecture, allowing administrators to define multiple zones with distinct settings such as interfaces, authentication servers, timeouts, and allowed MAC addresses. This change adds support for configuring idle and hard timeouts, enforcing group-based authentication, and managing custom login templates. It also introduces options to disable automatic firewall rules, send accounting requests, and include extended pre-authentication data, providing finer control over captive portal behavior and security policies.
src/opnsense/mvc/app/models/OPNsense/CaptivePortal · high confidence
Captive portal library refactored with new accounting and host lookup modules
The captive portal library has been reorganized into a new directory structure, introducing dedicated modules for database management, IPFW-based accounting, and ARP/host lookup. The new db.py module initializes a SQLite database with migrations for session restrictions and accounting state, while ipfw.py implements traffic accounting using ipfw rules and tables. The arp.py module now parses host discovery data in ISO 8601 format and handles JSON parsing errors safely. Additionally, pf.py provides IPv6-aware table management for the packet filter, and daemonize.py standardizes daemon startup with privilege dropping and logging.
src/opnsense/scripts/captiveportal/lib · high confidence
Captive portal scripts migrated to new location with accounting and template updates
The captive portal backend scripts have been moved from src/opnsense/scripts/OPNsense/CaptivePortal to src/opnsense/scripts/captiveportal. This change includes a new allow.py script that now passes the zoneid parameter to the accounting function, fixes a regression where allowed addresses were missing from session IPs, and excludes IPv4 from roaming logic. The cp-background-process.py script now handles IPv6 support and adjusts the accounting interval to match the Acct-Interim-Interval setting. Additionally, the generate\_certs.php script has been cleaned up to remove legacy config dependencies and unused certificates, while the process\_accounting\_messages.php script has been updated to re-introduce hash lookup for accounting purposes.
src/opnsense/scripts/captiveportal · high confidence
Centralized IPv6 prefix and interface auto-configuration data access
This change introduces two new classes in the Interface library to standardize how dynamic network configuration data is accessed. The new Autoconf class provides a unified static interface to retrieve interface properties (such as nameservers, routers, prefixes, and search domains) collected by the ifctl utility, replacing scattered direct file reads. Additionally, the Idassoc class implements logic to calculate and return IPv6 prefix information for interfaces using identity associations (idassoc6), including on-link, allocated, and associated prefixes. This centralization ensures that services like Kea DHCPv6 can reliably access consistent prefix state data, preventing crashes during initial configuration generation when real prefixes are not yet available.
src/opnsense/mvc/app/library/OPNsense/Interface · high confidence
Compiled assets for the official OPNsense dark theme
The build directory for the opnsense-dark theme has been updated with compiled CSS and font files. This includes styles for the new Tabulator-based data grids (replacing the previous bootgrid implementation), updated dashboard widget layouts, and specific styling for Bootstrap dialogs and select menus to ensure proper contrast and visibility in the dark interface.
src/opnsense/www/themes/opnsense-dark/build · high confidence
Configurable configd environment and new service action definitions
The configd service now supports a configurable environment, explicitly setting the PATH, HOME, and REQUESTS\_CA\_BUNDLE variables in the new configd.conf file to ensure consistent system certificate usage. Additionally, a new actions\_service.conf file defines standard service management actions (start, stop, restart, status, list) that delegate to the pluginctl utility, replacing previous hardcoded or script-based implementations.
src/opnsense/service/conf · high confidence
Configurable hostwatch discovery and cleanup intervals
The hostwatch service now supports configurable IPv4 and IPv6 expiration intervals, allowing administrators to define how long discovered hosts remain in the neighbor table before being cleaned up. This change introduces new settings for expire4\_interval and expire6\_interval, which are passed to the hostwatch daemon via command-line flags, providing more granular control over network discovery data retention compared to the previous default behavior.
src/opnsense/service/templates/OPNsense/Hostdiscovery · high confidence
Core system models migrated to the MVC framework
The core system configuration models—Access Control (ACL), Firmware, High Availability Sync (Hasync), Initial Setup Wizard, and System Tunables—have been rewritten as MVC models. This migration introduces structured validation for firmware subscription keys and wizard inputs, supports configurable user landing pages and source-network constraints in ACLs, and updates HA sync defaults (such as pfsync version 1500) to align with the new framework.
src/opnsense/mvc/app/models/OPNsense/Core · high confidence
Core version metadata now includes product tier and nickname
The core version metadata file has been renamed to 'core' and expanded to include new fields such as 'product\_tier' (set to 1) and 'product\_nickname', alongside existing product identifiers like series and ABI. This change ensures that the core package metadata exposes additional context about the product's tier and branding, which can be used by the system to better identify and manage core components and their relationships with other packages.
src/opnsense/version · high confidence
Cron job command migrations for Unbound and firmware updates
The system now automatically updates legacy cron job definitions to their current command names during migration. Specifically, Unbound DNSBL jobs previously using the 'unboundplus' command are updated to 'unbound', and firmware-related jobs are renamed from 'firmware changelog fetch' to 'firmware changelog cron' and from 'firmware probe' to 'firmware poll'. Additionally, IPsec reconfiguration jobs are migrated from 'ipsec reconfigure' to 'ipsec reload'. These changes ensure that scheduled tasks continue to function correctly after upgrades without manual intervention.
src/opnsense/mvc/app/models/OPNsense/Cron/Migrations · high confidence
Cron job generation now respects enabled/disabled status and uses safer parameter escaping
The cron template system has been updated to generate user crontabs that only include jobs marked as enabled, preventing disabled tasks from running. Additionally, command arguments and parameters are now escaped using shlex functions to handle special characters and options starting with minus signs correctly, addressing previous issues where shlex.quote behavior broke certain command-line options.
src/opnsense/service/templates/OPNsense/Cron · high confidence
DHC Relay configuration model introduces validation and CARP tracking
The DHC Relay service now enforces stricter configuration rules: users can no longer mix IPv4 and IPv6 addresses within a single destination, and each relay interface is limited to one destination per address family. Additionally, relays can now be configured to track CARP virtual IPs via the new \carp\_depend\_on\ field, and the model supports custom DHCP agent circuit and remote ID options.
src/opnsense/mvc/app/models/OPNsense/DHCRelay · high confidence
DHCP Relay GUI now displays relay status and uses snake\_case API endpoints
The DHCP Relay configuration page has been updated to include a 'Status' column in the relays table, allowing users to see the current state of each relay directly in the interface. Additionally, the underlying API calls for managing relays and destinations have been standardized to use snake\_case notation (e.g., /api/dhcrelay/settings/get\_relay/), ensuring consistency with the broader MVC framework changes.
src/opnsense/mvc/app/views/OPNsense/DHCRelay · high confidence
Deprecation of opnsense sudoers configuration
The specific sudoers configuration file for opnsense has been marked as obsolete and retained only for reference. Users should refer to the 20-sudoers file for current configuration settings, as this specific file is scheduled for removal in version 26.7.
src/etc/sudoers.d · high confidence
Diagnostics pages migrated to MVC controllers
The Diagnostics section of the web interface has been refactored from legacy PHP pages to the MVC framework. This change introduces dedicated controllers for system activity, DNS diagnostics, firewall logs and statistics, interface details (ARP, NDP, routing, VIPs, netstat), logging, netflow, network insight, packet capture, ping, port probe, system memory, system health, traceroute, and traffic. Users will see these diagnostics tools served through the new MVC structure, which standardizes the UI and integrates them with the modern frontend components.
src/opnsense/mvc/app/controllers/OPNsense/Diagnostics · high confidence
Diagnostics settings migration to MVC model
The Diagnostics settings have been converted to the MVC architecture, introducing a new migration script (M1\_0\_0) for the SystemHealth model. This migration automatically transfers the RRD (Round Robin Database) enable status from the legacy configuration to the new model and cleans up the old configuration entries to ensure a smooth transition for existing users.
src/opnsense/mvc/app/models/OPNsense/Diagnostics/Migrations · high confidence
Diagnostics tools migrated to MVC model structure
The configuration models for core diagnostics tools—Ping, DNS Lookup, Port Probe, Traceroute, Packet Capture, and NetFlow—have been converted to the MVC framework. This migration introduces standardized XML-based model definitions that enforce input validation (such as valid hostnames, IP addresses, and port ranges) and define specific settings like protocol families (IPv4/IPv6), interface selection, and NetFlow collection timeouts. Users benefit from consistent form behavior, improved data integrity checks, and unified configuration management across all network diagnostic utilities.
src/opnsense/mvc/app/models/OPNsense/Diagnostics · high confidence
Dnsmasq field validation and migration improvements
The Dnsmasq configuration model now enforces stricter validation for hostnames and domains, ensuring labels comply with RFC1035 standards (1–63 characters, alphanumeric with hyphens/underscores) and optionally limiting total domain length to 255 characters. The DomainIPField has been updated to allow the IP address portion to be cleared (empty), and legacy XML structures containing host/domain pairs are automatically flattened and migrated to the new format. Additionally, the RangeAddressField now correctly handles IPv6 ranges that start with '::' by validating them as valid IPv6 addresses.
src/opnsense/mvc/app/models/OPNsense/Dnsmasq/FieldTypes · high confidence
Dnsmasq migration normalizes interfaces and migrates domain-based hostnames
The Dnsmasq configuration migration (M1\_0\_0) now ensures that stale interface selections do not cause validation errors by normalizing the interface value. Additionally, it handles legacy host entries where the hostname field was empty but a domain was specified: the migration automatically copies the domain value into the hostname field and clears the domain field, ensuring existing host records are correctly formatted for the current model structure.
src/opnsense/mvc/app/models/OPNsense/Dnsmasq/Migrations · high confidence
Dnsmasq model migration to MVC with enhanced validation and new configuration options
The Dnsmasq service configuration model has been migrated to the MVC architecture, introducing stricter validation rules and new configuration capabilities. Users will see enforced uniqueness for DHCP IP addresses and CNAMEs, with specific checks preventing duplicate IPs in DHCP reservations and overlapping CNAMEs with host overrides. The model now supports new features including CNAME configuration for host overrides, IPset support for domain overrides, and refined DHCP range validation (requiring end addresses for 'Range' type domains). Additionally, the configuration schema now includes fields for DNS port selection, logging controls (log\_dhcp, log\_quiet), and DHCPv6 options, providing more granular control over the Dnsmasq service behavior.
src/opnsense/mvc/app/models/OPNsense/Dnsmasq · high confidence
Dnsmasq service migrated to MVC/API architecture
The Dnsmasq configuration and management interface has been migrated from the legacy system to the modern MVC/API framework. This change introduces new API controllers for handling leases, service status, and settings, replacing the previous implementation. Users will now interact with the Dnsmasq DNS and DHCP settings through the updated API endpoints, which support features such as safe deletion of tags, protocol-based filtering in the leases view, and CSV import/export for host overrides.
src/opnsense/mvc/app/controllers/OPNsense/Dnsmasq/Api · high confidence
Dynamic aliases now include Captive Portal zones and interface networks
The firewall alias system now automatically generates dynamic aliases for Captive Portal zones (marked as type 'external') and local interface networks (marked as type 'internal'). This allows these resources to be directly referenced in firewall rules without manual maintenance, resolving issues where Captive Portal zones were previously unavailable for rule targeting.
src/opnsense/mvc/app/models/OPNsense/Firewall/DynamicAliases · high confidence
Firewall UI migrated to MVC architecture
The Firewall management interface has been migrated from the legacy PHP-based UI to the modern Model-View-Controller (MVC) framework. This change introduces dedicated controllers for all firewall components—including filter rules, NAT (Source, Destination, One-to-One, NPT), Aliases, Groups, Categories, and Settings—ensuring a consistent, grid-based user experience across the entire firewall configuration section.
src/opnsense/mvc/app/controllers/OPNsense/Firewall · high confidence
Firewall configuration migrated to new MVC model architecture
The Firewall module's configuration models (Aliases, Categories, Destination NAT, Firewall Rules, and Interface Groups) have been migrated to the new Model-View-Controller (MVC) framework. This change introduces new model classes and XML definitions that enforce stricter validation rules—such as ensuring address types match the selected IP protocol version and preventing invalid combinations of fields like 'any' with other aliases. It also adds new capabilities like firewall rule categories with color coding, improved alias management with authentication support, and refined Source/Destination NAT options, while maintaining backward compatibility through migration scripts.
src/opnsense/mvc/app/models/OPNsense/Firewall · high confidence
Firewall diagnostics scripts rewritten in Python 3
The firewall diagnostics and management scripts in src/opnsense/scripts/filter have been converted from Python 2 to Python 3. This update replaces legacy implementations with modern Python 3 code for listing and managing firewall states, tables, and rules, ensuring compatibility with the current system runtime and improving the reliability of diagnostic commands like state listing and table management.
src/opnsense/scripts/filter · high confidence
Firewall menu structure migrated to MVC with legacy fallbacks
The Firewall section of the web UI now uses a new MVC-based menu system defined in Menu.php and Menu.xml. This introduces modern MVC pages for Rules, Source NAT, Destination NAT, One-to-One NAT, NPTv6, and Settings. To ensure continuity, the system detects the presence of legacy PHP files (firewall\_rules.php, firewall\_nat\_out.php) and conditionally displays '\[legacy\]' labeled menu items for Rules and Outbound NAT, while also showing a Migration Assistant entry if legacy firewall rules or outbound NAT rules exist in the configuration.
src/opnsense/mvc/app/models/OPNsense/Firewall/Menu · high confidence
Firmware update scripts restructured into modular components
The firmware update backend has been refactored from a monolithic script into a modular system of specialized shell scripts (bogons, changelog, check, cleanup, connection, health, install, lock, query, etc.) orchestrated by a central launcher. This change improves maintainability and allows individual update tasks—such as bogon table updates, changelog fetching, and health audits—to be executed independently and safely via the launcher, which handles locking, environment initialization, and output piping.
src/opnsense/scripts/firmware · high confidence
Health reporting scripts refactored and migrated to Python 3
The health reporting backend in src/opnsense/scripts/health has been rewritten to use Python 3, replacing the previous implementation. This change introduces new scripts for fetching RRD data (fetchData.py), listing available reports with metadata (listReports.py), and flushing RRD files (flush\_rrd.py), while the PHP-based updater (updaterrd.php) now utilizes the OPNsense MVC framework and RRD factory for data collection. The refactoring specifically addresses issues with RRD files containing single measurements and ensures NaN values are handled correctly, improving the reliability of system health statistics.
src/opnsense/scripts/health · high confidence
IPsec configuration migration for version 1.0
This update introduces a series of configuration migrations (M1\_0\_0 through M1\_0\_4) that automatically update existing IPsec settings to the new model structure. The process initializes missing request IDs for Phase 2 entries, consolidates pre-shared keys from legacy user and mobile key sections into a unified module, and moves advanced settings such as syslog options, passthrough networks, and VPN rule disabling to their correct locations. Additionally, it migrates mobile client attributes—including DNS, WINS, domain, banner, and RADIUS configurations—into the Charon plugin settings, ensuring a seamless transition without manual intervention.
src/opnsense/mvc/app/models/OPNsense/IPsec/Migrations · high confidence
IPsec management scripts migrated to Python 3 and swanctl
The IPsec diagnostic and management scripts in src/opnsense/scripts/ipsec have been rewritten in Python 3 to replace the legacy stroke-based implementation. These scripts now interact with the swanctl daemon via the vici interface to provide status, Security Association Database (SAD), and Security Policy Database (SPD) information, as well as connection control and lease listing. Additionally, the legacy interface reload script has been replaced by a Python script that retrieves the current swanctl configuration, and a new event handler supports dynamic Virtual Tunnel Interface (VTI) and manual SPD configuration based on connection events.
src/opnsense/scripts/ipsec · high confidence
IPsec model validation enforces key pair matching and protocol constraints
The IPsec configuration models now include stricter validation logic to ensure configuration integrity. The IPsec model validates that private and public keys in key pairs actually match by comparing their SHA1 fingerprints, preventing the use of mismatched key material. The Swanctl model enforces that post-quantum key exchange methods (mlkem) are only used with IKEv2 connections and children, and adds validation for Virtual Tunnel Interfaces to ensure local and remote addresses use matching protocol families (IPv4/IPv6). Additionally, remote authentication configurations now require choosing either certificate or authority matching, but not both.
src/opnsense/mvc/app/models/OPNsense/IPsec · high confidence
Improved OpenVPN gateway detection and link management
OpenVPN server connections now more reliably determine the tunnel gateway address by falling back to parsing interface details when standard variables are unavailable, ensuring correct routing setup. The link-up and link-down scripts have been updated to use the ifctl utility for route management and to trigger interface IP updates, while the system no longer flushes the state table or reloads on disconnect, resulting in smoother connection handling.
src/etc/inc/plugins.inc.d/openvpn · high confidence
Improved certificate management with external source support and lazy loading
The Trust model field types now support loading certificates from external configuration directories (e.g., /usr/local/etc/ssl/ext\_sources/) alongside locally managed ones, allowing users to reference certificates not created within OPNsense. Additionally, the Certificate model now supports lazy loading, which skips the parsing of dynamic content during export operations to improve performance, and includes stricter validation for certificate reference IDs to prevent migration issues.
src/opnsense/mvc/app/models/OPNsense/Trust/FieldTypes · high confidence
Interfaces menu structure migrated to MVC model
The Interfaces section of the web UI menu has been refactored from static XML definitions to a dynamic MVC model. The new Menu.php class now programmatically constructs the menu hierarchy by reading the system configuration, ensuring that interface groups and individual interfaces are listed in the correct order and that wireless status tabs are dynamically generated for WLAN interfaces. This change aligns the Interfaces menu with the broader MVC migration effort, replacing the previous static XML approach with a code-based implementation that handles interface descriptions, group memberships, and ordering logic directly.
src/opnsense/mvc/app/models/OPNsense/Interfaces/Menu · high confidence
Interfaces module migrated to MVC model architecture
The interface configuration system has been refactored to use the MVC model framework, introducing dedicated model classes and XML definitions for network interfaces, virtual IPs, bridges, LAGG, GIF, GRE, loopbacks, and neighbor entries. This change standardizes validation logic (such as ensuring CARP VHIDs are unique per interface and that proxy ARP uses strict subnets), enforces unique constraints on device assignments, and provides a unified structure for managing interface settings and assignments.
src/opnsense/mvc/app/models/OPNsense/Interfaces · high confidence
Interfaces: Migrate configuration pages to MVC framework
The Interfaces configuration pages (including Assignment, Bridge, GIF, GRE, LAGG, Loopback, Neighbor, Overview, Settings, Virtual IP, VLAN, VXLAN, and Wireless) have been migrated to the MVC framework. This change replaces the legacy implementation with new controller classes that serve the corresponding UI views and forms, ensuring a consistent and modern interface for managing network interfaces.
src/opnsense/mvc/app/controllers/OPNsense/Interfaces · high confidence
Interfaces: Migrate configuration views to MVC and Bootgrid
The Interface configuration pages (Assignments, Bridge, GIF, GRE, LAGG, Loopback, Neighbor, Overview, Settings, Virtual IPs, VLAN, VXLAN, and Wireless) have been rewritten as new MVC views. These views replace the legacy UI with a standardized Bootgrid-based interface, connecting to dedicated API endpoints for search, get, set, add, and delete operations, and utilizing shared layout partials for tables, apply buttons, and edit dialogs.
src/opnsense/mvc/app/views/OPNsense/Interface · high confidence
Introduce IPFW-based firewall and traffic shaping configuration templates
The system now generates firewall rules and traffic shaping configurations using the IPFW framework instead of the previous method. This change introduces new template files that define the rc.conf settings, main IPFW ruleset, and address tables. For users, this means the Captive Portal now utilizes IPFW zones for interface-based access control and accounting, while the Traffic Shaper generates specific IPFW rules that support advanced options like DSCP marking, TCP ACK filtering, and interface-specific direction handling. The configuration also ensures that localhost traffic is correctly handled and that unmatched traffic is explicitly blocked.
src/opnsense/service/templates/OPNsense/IPFW · high confidence
Introduce Kea DHCP API controllers for configuration and lease management
This change adds a new set of API controllers in the Kea module to manage DHCPv4 and DHCPv6 services, replacing the previous implementation. The new controllers expose endpoints for managing subnets, reservations, options, and high-availability peers, and introduce CSV import/export functionality for reservations. It also adds dedicated controllers for retrieving and deleting DHCP leases (v4 and v6) via the backend, providing users with updated tools to manage their DHCP infrastructure.
src/opnsense/mvc/app/controllers/OPNsense/Kea/Api · high confidence
Introduce MVC-based ACL model and core permission definitions
The system now uses a new PHP ACL class to load and parse access control lists from XML configuration files, replacing the previous legacy mechanism. This change introduces a standardized way to define permissions for UI and API endpoints, as evidenced by the new ACL.xml file which maps specific UI paths and API routes (such as dashboard, diagnostics, and firewall alias pages) to named permission entries. For users, this ensures that access rights for core system functions are now managed through a consistent, model-driven structure.
src/opnsense/mvc/app/models/OPNsense/Core/ACL · high confidence
Introduce Python 3-based Netflow Aggregation and Reporting Scripts
The netflow processing pipeline in src/opnsense/scripts/netflow has been migrated to Python 3, replacing the previous implementation. This change introduces a new flowd aggregator (flowd\_aggregate.py) that streams parsed flow data into SQLite databases for reporting, supporting configurable resolutions and automatic database vacuuming. New utility scripts have been added to support this architecture: dump\_log.py for raw log parsing, export\_details.py for CSV-based data export, get\_timeseries.py and get\_top\_usage.py for querying aggregated metrics, flowctl\_stats.py for displaying live netflow cache statistics, and flush\_all.sh for clearing local netflow data. The migration also includes fixes for type handling (bytes vs strings) and ensures compatibility with the updated reporting and network insight features.
src/opnsense/scripts/netflow · high confidence
Introduce standardized MVC form and layout partials
The layout partials have been replaced with a new set of reusable MVC templates, including base\_form, base\_dialog, base\_apply\_button, base\_bootgrid\_table, and base\_menu\_system. This change standardizes the rendering of configuration forms, dialogs, and navigation menus across the web interface, introducing features such as collapsible form sections, integrated search within dialogs, a centralized apply button with progress feedback, and a consistent grid/table layout for data lists.
_src/opnsense/mvc/app/views/layout\partials · high confidence
Introduction of a custom OpenSSL configuration file for certificate generation
The system now uses a dedicated OpenSSL configuration file (opnsense.cnf) for generating certificates and certificate signing requests (CSRs). This change replaces the previous reliance on default OpenSSL settings or external templates, allowing for consistent, system-defined policies for certificate validity (set to 825 days), key usage, and distinguished name requirements. Users will benefit from standardized certificate generation that aligns with OPNsense's specific security policies, including support for Subject Alternative Names (SANs) and specific key usage extensions like 'IP security IKE intermediate' for server certificates.
src/etc/ssl · high confidence
Intrusion Detection System configuration migrations
This update adds a series of migration scripts for the Intrusion Detection System (IDS) model to handle upgrades between versions. M1\_0\_0 initializes version tracking. M1\_0\_2 disables user-defined rules that use deprecated GeoIP settings and appends a note to their descriptions. M1\_0\_6 migrates legacy file download filters into the new policy system. M1\_0\_7 updates the Emerging Threats (et-open) ruleset configuration for Suricata 5 compatibility by mapping old rulesets to new ones (e.g., current\_events to phishing/exploit\_kit, trojan to coinminer/malware) and removing the deprecated trojan ruleset. M1\_1\_1 clears the deprecated 'ac-bs' Multi-Pattern Matching algorithm. M1\_1\_2 migrates legacy IPS mode settings to the new 'netmap' capture mode.
src/opnsense/mvc/app/models/OPNsense/IDS/Migrations · high confidence
Kea DHCP: Added validation for static routes and pool configurations
The Kea DHCP service now includes specific field validators to ensure configuration integrity. A new KeaClasslessStaticRouteField validates DHCP Option 121 (Classless Static Routes), requiring entries to be valid destination network and router IP pairs. Additionally, KeaStaticRoutesField validates standard static route entries as destination and router IP pairs, while KeaPoolsField enforces that defined IP ranges or subnets are strictly contained within their assigned subnet, preventing invalid pool assignments.
src/opnsense/mvc/app/models/OPNsense/Kea/FieldTypes · high confidence
Local OUI vendor lookup replaces external dependency
The interface library now uses a local implementation to map MAC addresses to vendor names by reading the IEEE OUI CSV file at /usr/local/opnsense/contrib/ieee/oui.csv. This change removes the previous external dependency for MAC vendor mapping, ensuring that vendor identification remains available even if external services are unreachable, and improves reliability by relying on a static local database.
src/opnsense/scripts/interfaces/lib · high confidence
Migrate Gateway Groups and Gateways to MVC API controllers
The Routing module's Gateway Groups and Gateways configuration interfaces have been migrated to the MVC framework. This introduces new API controllers (GroupSettingsController and SettingsController) that handle CRUD operations, search, and reconfiguration for gateway groups and individual gateways. The migration includes specific behavioral improvements: gateway deletion is now prevented if a gateway is bound to an interface, and the search API ensures proper data types are emitted when configuration daemon actions fail, addressing previous inconsistencies and potential errors.
src/opnsense/mvc/app/controllers/OPNsense/Routing/Api · high confidence
Migrate Gateway and Gateway Groups configuration to MVC
The Routing module's configuration interfaces for Gateways and Gateway Groups have been migrated to the MVC framework. This introduces new controllers (ConfigurationController and GatewayGroupsController) that serve the settings pages, utilizing MVC-specific form definitions and grid components to manage gateway and gateway group configurations.
src/opnsense/mvc/app/controllers/OPNsense/Routing · high confidence
Migrate User and Group management to the new MVC model layer
The User and Group configuration models in the Auth module have been rewritten to use the new MVC framework. This introduces dedicated model classes (User.php, Group.php, Priv.php) and XML definitions that define the data structure, including new fields for API keys, shell access, language preferences, dashboard layouts, and menu favorites. The User model now enforces validation rules such as preventing system users from changing their names and requiring passwords, while also supporting Argon2id password hashing. The Group model adds support for source network constraints to limit endpoint access based on user address.
src/opnsense/mvc/app/models/OPNsense/Auth · high confidence
Migrate User, Group, and Privilege management to MVC controllers
The User, Group, and Privilege management interfaces in the Authentication section have been migrated to the MVC framework. New controllers (UserController, GroupController, PrivController) now handle these pages, loading their respective forms and grids via the API. The User controller also includes specific JavaScript and CSS assets for QR code generation and date picking, indicating enhanced functionality for user profile management.
src/opnsense/mvc/app/controllers/OPNsense/Auth · high confidence
Migrate Users, Groups, and Privileges to MVC/API with enhanced grid features
The Users, Groups, and Privileges management pages have been migrated to a new MVC/API architecture, replacing the previous implementation with modern Bootgrid-based interfaces. This change introduces several user-facing improvements: the Users grid now supports direct export/import of user data, displays approximate expiration status for accounts, and includes new command buttons to search for associated certificates and generate/download API keys for individual users. The Privileges page has been simplified by removing the ability to add or delete privileges directly from the grid view. Additionally, styling conflicts have been resolved and URL hash handling in links has been fixed to ensure correct menu navigation after redirection.
src/opnsense/mvc/app/views/OPNsense/Auth · high confidence
Migrate core system pages to the MVC architecture
The core system interface pages—including Dashboard, Services, Firmware, License, Reboot, Halt, Snapshots, Tunables, Initial Setup, and High Availability (Hasync)—have been ported from the legacy codebase to the new Model-View-Controller (MVC) structure. This change modernizes the underlying framework for these administrative functions, ensuring consistent routing and view handling across the system's foundational settings and maintenance tools.
src/opnsense/mvc/app/controllers/OPNsense/Core · high confidence
Migrate gateway and gateway group configuration to MVC models
The gateway and gateway group configuration logic has been migrated to the MVC framework. New model files (GatewayGroups.php, Gateways.php, and their XML definitions) now handle validation, data storage, and configuration management for these components. This change introduces stricter validation rules, such as preventing name changes on existing gateways and groups, ensuring unique monitor IPs, and enforcing that gateway group tiers contain at least one member. It also standardizes the configuration structure by replacing individual tier fields with a unified 'tiers' array in the data model.
src/opnsense/mvc/app/models/OPNsense/Routing · high confidence
Migrate gateway and gateway group field types to MVC
The gateway and gateway group configuration fields have been migrated to the MVC model layer. This introduces new field types (GatewayField and GatewayGroupItemField) that handle data storage and validation, including setting a default data length of 1 byte for single gateways to prevent potential packet drops and managing tiered gateway group assignments.
src/opnsense/mvc/app/models/OPNsense/Routing/FieldTypes · high confidence
Migrate gateway configuration to the new MVC model
The system now migrates existing gateway settings from the legacy configuration structure into the new MVC-based model. This process converts legacy 'dynamic' gateway values to empty strings, normalizes implied boolean flags (such as default gateway, disabled, and force\_down) into explicit '1' or '0' values, and applies default values for priority, IP protocol, and weight if they are missing. The migration also ensures that time periods for gateway monitoring are adjusted if they were previously set too low, and it logs any validation errors that cause a gateway to be skipped during the transition.
src/opnsense/mvc/app/models/OPNsense/Routing/Migrations · high confidence
Migrate legacy DHCP relay configurations to the new unified model
The system now automatically migrates existing DHCP relay settings from the legacy configuration nodes (dhcrelay for IPv4 and dhcrelay6 for IPv6) into the new unified DHCRelay model structure. This process converts the previous flat interface and server settings into structured relay and destination entries, ensuring that your existing IPv4 and IPv6 relay rules are preserved and functional under the new architecture, after which the old configuration nodes are removed.
src/opnsense/mvc/app/models/OPNsense/DHCRelay/Migrations · high confidence
Migrate legacy firewall configuration to MVC models
This update introduces a series of migration scripts (M1\_0\_0 through MFP1\_0\_9) that automatically convert legacy firewall settings into the new Model-View-Controller (MVC) structure. Users will see their existing firewall aliases, NAT rules (including NPTv6 and one-to-one NAT), filter rules, and scrub options automatically migrated to the new system. The migration handles data normalization, such as converting legacy port ranges and address formats, and ensures that legacy configuration nodes are cleaned up after the transfer to prevent conflicts.
src/opnsense/mvc/app/models/OPNsense/Firewall/Migrations · high confidence
Migrate legacy system and wireless interface settings to new MVC models
This change introduces migration scripts that move configuration data from the legacy system-level settings (such as DHCPv6 debug, no-release, checksum offloading, and IPv6 settings) and legacy wireless interface configurations into the new MVC-based models. For system settings, existing values are transferred to the new model structure with appropriate defaults applied, and the old system-level keys are removed from the configuration. For wireless interfaces, legacy wireless properties (including WEP/WPA keys, IEEE 802.1x settings, and mode flags like pureg/puren/turbo) are migrated into the new clone-based model structure, ensuring that only one clone per interface is marked as the primary (use\_common) while others are secondary, and the old wireless configuration nodes are cleaned up.
src/opnsense/mvc/app/models/OPNsense/Interfaces/Migrations · high confidence
Migrate package repository configuration to OPNsense.conf and introduce shadow files
The package manager configuration has been migrated from the legacy origin.conf file to a new OPNsense.conf structure. To support future compatibility with pkg 1.20 and allow for selective repository enabling, shadow configuration files (FreeBSD.conf.shadow, OPNsense.conf.shadow.in, and OPNsense-aux.conf.shadow.in) have been introduced. These shadow files define the default state of repositories, such as disabling FreeBSD-base and ports by default and setting the OPNsense-aux repository to disabled unless explicitly checked, ensuring a smoother transition and better control over which package sources are active.
src/etc/pkg/repos · high confidence
Migration to new MVC framework with updated routing and error handling
The web interface has been migrated from the legacy Phalcon application to a new MVC framework, introducing new entry points at /ui/ and /api/. This change updates how requests are routed, including a fallback to the core index page for unroutable UI requests and specific handling for legacy password management URLs. Error handling has been restructured: API errors now return structured JSON responses with HTTP status codes, while unhandled UI exceptions redirect users to a crash reporter page. Additionally, static assets are now served with cache-busting hashes based on file modification times to ensure proper caching behavior.
src/opnsense/www · high confidence
Migration to syslog-ng and unified logging infrastructure
The system logging backend has been migrated from the legacy syslogd to syslog-ng, introducing a more robust and flexible logging architecture. This change includes the removal of the previous syslogd workaround, the consolidation of core syslog facilities into the core plugin, and the addition of TLS transport options for remote logging targets. Users will benefit from improved reliability in log forwarding, better handling of remote syslog configurations, and a unified logging flow that reduces spurious errors and simplifies debugging across the system.
src/etc/inc · high confidence
Migration to syslog-ng with TLS support and local log management
The system logging infrastructure has been replaced with syslog-ng, introducing new configuration templates for managing log destinations and local storage. Users can now configure remote logging targets with TLS transport (supporting both IPv4 and IPv6) and RFC5424 compliance, including automatic handling of CA/CRL directories and certificate files. Local logging is now managed via a new newsyslog configuration and specific syslog-ng destination files, ensuring proper log rotation and file creation. Additionally, the system includes dedicated handlers for lockout events and configuration change events, routing them to specific scripts or destinations for enhanced monitoring and security auditing.
src/opnsense/service/templates/OPNsense/Syslog · high confidence
Monit configuration migration and service path updates
The Monit model migration scripts have been updated to handle configuration changes during upgrades. M1\_0\_0 initializes default system and filesystem services with associated resource tests (CPU, memory, load average, etc.) and inherits SMTP settings from the system notifications. Subsequent migrations (M1\_0\_6, M1\_0\_7) add default tests for program status changes and gateway alerts, linking them to new custom services (carp\_status\_change, gateway\_alert). M1\_0\_8 ensures test types are correctly assigned based on conditions. Finally, M1\_0\_14 updates the file paths for the carp\_status and gateway\_alert scripts to reflect their new location under /usr/local/opnsense/scripts/monit/.
src/opnsense/mvc/app/models/OPNsense/Monit/Migrations · high confidence
NTP status page now displays GPS data and uses AJAX-driven table
The NTP status view has been refactored to use an MVC-based Volt template that loads the NTP peer table via AJAX from the API, replacing the previous static rendering. This change introduces a new GPS Information section that displays latitude, longitude, altitude, and satellite usage details when available, including a link to view the location on Google Maps. The table headers and status/type columns now include tooltips for additional context, improving the clarity of the NTP synchronization status for users.
src/opnsense/mvc/app/views/OPNsense/Ntpd · high confidence
Native OPNsense validators replace Phalcon dependencies
The validation layer in the MVC models has been decoupled from the Phalcon framework by introducing a set of native validators in the OPNsense\\Base\\Validators namespace. This change replaces Phalcon's built-in validators (PresenceOf, Url, Regex, Numericality) and adds a new CallbackValidator, allowing configuration validation to function independently of the underlying Phalcon version. Users benefit from a more stable validation foundation that is no longer tied to specific Phalcon API changes, ensuring consistent behavior across framework upgrades.
src/opnsense/mvc/app/models/OPNsense/Base/Validators · high confidence
New Cron job management interface with inline editing and reconfiguration
The Cron settings view has been replaced with a new Volt template that provides a grid-based interface for managing scheduled jobs. Users can now edit individual jobs via an inline dialog that automatically triggers a cron reconfiguration upon saving, ensuring changes are applied immediately. The interface also includes a dedicated 'Apply' button for batch changes and utilizes a standardized bootgrid table for job listing.
src/opnsense/mvc/app/views/OPNsense/Cron · high confidence
New GeoIP configuration and alias table generation templates
The firewall service now uses dedicated Jinja2 templates to generate its configuration files. A new \filter\_geoip.conf\ template manages the GeoIP data source URL, supporting custom URLs, or automatically falling back to the Deciso mirror for business edition subscribers. Additionally, a new \filter\_tables.conf\ template generates the firewall alias table definitions, handling various alias types (URL, JSON, dynamic IPv6, MAC, etc.) with specific TTLs and interface mappings, and includes a new \+TARGETS\ file to ensure these configuration files are properly deployed.
src/opnsense/service/templates/OPNsense/Filter · high confidence
New IPsec MVC field types for configuration validation and proposal selection
The IPsec configuration module now uses dedicated MVC field types to handle specific settings more robustly. A new CharonLogLevelField allows users to select detailed logging levels for the IPsec daemon. The IPsecProposalField defines available encryption and hashing algorithms, including AEAD ciphers like AES-GCM and ChaCha20-Poly1305, as well as post-quantum key exchange options. Supporting fields like IKEAddressField validate IP addresses and subnets, while ConnnectionField, SPDField, and VTIField manage connection attributes, Security Policy Database entries, and Virtual Tunnel Interfaces respectively. PoolsField provides a list of available IP pools for selection.
src/opnsense/mvc/app/models/OPNsense/IPsec/FieldTypes · high confidence
New MVC controllers for Traffic Shaper UI and statistics
The Traffic Shaper interface now uses new MVC controllers (IndexController and ServiceController) to serve the main configuration page and statistics. The IndexController loads form definitions for pipes, queues, and rules, while the ServiceController provides a statistics action, replacing the previous legacy PHP-based page structure with a modern API-enabled frontend.
src/opnsense/mvc/app/controllers/OPNsense/TrafficShaper · high confidence
New MVC exception hierarchy for dispatch errors
The MVC layer now includes a dedicated set of exception classes under the \OPNsense\\Mvc\\Exceptions\ namespace to handle dispatch-related issues. A new base \DispatchException\ class has been introduced, with specific subclasses added for \ClassNotFoundException\, \InvalidUriException\, \MethodNotFoundException\, and \ParameterMismatchException\. This structure allows for more precise error handling and reporting when specific dispatch conditions are encountered.
src/opnsense/mvc/app/library/OPNsense/Mvc/Exceptions · high confidence
New MVC menu system with caching and graceful error handling
The navigation menu is now generated by a new MVC-based system that collects XML definitions from module directories, merges them into a cached file, and serves them to the UI. This change improves performance through caching and ensures the interface remains stable by logging errors for malformed menu XML files instead of crashing the application.
src/opnsense/mvc/app/models/OPNsense/Base/Menu · high confidence
New Monit status and configuration views
The Monit service now features new MVC-based views for the status page and general configuration. The status page dynamically loads HTML content via an API call to display real-time monitoring information, while the configuration interface provides a tabbed layout for managing general settings, alerts, services, and service tests with dynamic field visibility based on service types.
src/opnsense/mvc/app/views/OPNsense/Monit · high confidence
New PAM-based authentication and shell timeout configuration
The system now uses PAM (Pluggable Authentication Modules) for SSH, system console, and IPsec authentication, integrating the custom \pam\_opnsense.so\ module alongside standard \pam\_unix\ and \pam\_login\_access\ modules. This change replaces previous authentication mechanisms, allowing for local account locking and more flexible authentication flows. Additionally, a new \csh.cshrc\ template introduces a configurable shell inactivity timeout (\autologout\) for csh/tcsh sessions, and the Message of the Day (MOTD) has been updated with a new logo and links to the Reddit community.
src/opnsense/service/templates/OPNsense/Auth · high confidence
New PAM-based authentication services for IPsec, System, and WebGui
This change introduces new authentication service implementations for IPsec, System (console/login), and WebGui access, moving these areas to a unified PAM-based framework. The IPsec service now enforces group constraints based on configuration, while the System and WebGui services support multiple authenticators (such as Local Database) and handle specific user scenarios like the installer account. This provides a consistent authentication mechanism across different system entry points.
src/opnsense/mvc/app/library/OPNsense/Auth/Services · high confidence
New Python-based NetFlow log parser and aggregation library
The NetFlow processing pipeline in src/opnsense/scripts/netflow/lib has been replaced with a new pure-Python implementation. This change introduces a new flow parser (flowparser.py) that reads binary flowd logs, handles struct unpacking errors gracefully, and maps interface indexes to names. It also adds an aggregation layer (aggregate.py) that stores processed data in SQLite with UTC timestamps and metadata tracking. This new library serves as the backend for the flowd aggregator, improving reliability and performance over the previous implementation.
src/opnsense/scripts/netflow/lib · high confidence
New UIModelGrid helper and XSS-safe ViewTranslator
The MVC base library now includes a new UIModelGrid helper class that simplifies grid data fetching by retrieving descriptive values directly from the model and supporting multi-clause search phrases, and a new ViewTranslator class that wraps Phalcon's Gettext adapter to ensure all translated strings are automatically HTML-safe, preventing XSS vulnerabilities in the UI.
src/opnsense/mvc/app/library/OPNsense/Base · high confidence
New boot loader branding and logo assets for OPNsense
The boot loader now includes dedicated Lua scripts to render the OPNsense brand identity and a themed hourglass logo during startup. Specifically, \brand-opnsense.lua\ registers the OPNsense ASCII art logo with the boot drawer, while \logo-hourglass.lua.in\ defines a colored hourglass graphic (with series text substitution) to replace the previous default visuals, aligning the boot-time appearance with the 15.x release branding.
src/root · high confidence
New boot-time service hooks for interface, system, and VPN configuration
The system now executes a series of new startup hooks in /etc/rc.syshook.d/start to standardize post-boot configuration. These hooks ensure that IPv4 and IPv6 interfaces are reconfigured if pending changes exist, restart syslog to apply dynamic addressing, re-apply sysctl tunables after module loading, restart cron, configure OpenVPN instances, and set CARP preempt settings. This change centralizes these tasks using configctl and pluginctl, improving reliability for static setups and dynamic backend scripts.
src/etc/rc.syshook.d/start · high confidence
New default configuration and boot sequence for fresh installations
The system now uses a new default configuration sample (config.xml.sample) and a dedicated boot script (rc.bootup) for fresh installations. The default configuration sets the timezone to Etc/UTC, the DHCP domain to 'internal', enables Dnsmasq as the default DNS provider, sets outbound NAT to automatic mode, and includes default firewall rules allowing LAN traffic. The new boot sequence initializes the system, applies the default firewall policy before interface setup, and configures services in a specific order to ensure stability during the initial boot process.
src/etc · high confidence
New end-of-life upgrade guidance in the web GUI
A new upgrade page (upgrade.html.in) has been added to the firmware data directory to guide users when their current OPNsense series has reached end-of-life. The page explains that upgrading to the next series is seamless via the web GUI, while also offering alternative methods such as importing configuration with a new installation image (supporting ZFS or UFS) or performing a console/SSH upgrade via option 12. It advises users to review migration notes, back up their configuration, preview the new version, and create VM or ZFS snapshots before proceeding.
src/opnsense/data/firmware · high confidence
New pluggable backup provider framework with improved encryption
The backup system has been refactored to support a pluggable provider architecture, introducing a new \IBackupProvider\ interface, a \BackupFactory\ for discovering and instantiating providers, and a \Base\ class for shared logic. This change upgrades the encryption mechanism for configuration backups from MD5 to SHA-512 with PBKDF2 key derivation, enhancing security while maintaining backward compatibility for decrypting older backups. The framework also ensures that backup passphrases are not leaked to the process list during encryption and decryption operations.
src/opnsense/mvc/app/library/OPNsense/Backup · high confidence
New stop hooks for beep, FreeBSD services, and config locking
The system now executes specific actions when stopping services: it triggers the OPNsense beep utility, stops FreeBSD local services via the rc.freebsd script, and ensures exclusive locking on the configuration file (/conf/config.xml) during the stop phase to prevent concurrent modifications.
src/etc/rc.syshook.d/stop · high confidence
New theme assets and UI component styles
The Opnsense theme now includes compiled CSS for several new or updated UI components: bootstrap-dialog styles for styled modal dialogs, dashboard styles for widget layout and ChartJS rendering, and tokenize2 styles for tag-input fields. Additionally, the legacy bootgrid table styling has been replaced with Tabulator table styles, and the main theme stylesheet has been updated to include font definitions and base resets.
src/opnsense/www/themes/opnsense/build/css · high confidence
OpenVPN Client Specific Overrides migrate to MVC model
The OpenVPN Client Specific Overrides (CSO) configuration has been migrated from the legacy XML config structure to the new MVC model. Existing CSO settings are automatically imported into the new model during the upgrade process, and the old configuration entries are removed after the migration completes, ensuring a seamless transition for users managing per-client VPN overrides.
src/opnsense/mvc/app/models/OPNsense/OpenVPN/Migrations · high confidence
OpenVPN MVC field types for instances, servers, and validation
The OpenVPN configuration model now uses dedicated MVC field types to handle instance references, server selection, and input validation. The InstanceField automatically generates virtual properties for runtime files (such as config, PID, and socket paths) based on the instance UUID, while the OpenVPNServerField provides a unified, cached dropdown of available OpenVPN servers (both legacy and MVC-managed) for selection. Additionally, the RemoteHostField now validates comma-separated host:port entries to ensure valid hostnames or IPs and ports within the 1-65535 range, and the VPNIdField ensures unique VPN IDs by checking against legacy reserved IDs and auto-assigning the next available ID if none is provided.
src/opnsense/mvc/app/models/OPNsense/OpenVPN/FieldTypes · high confidence
OpenVPN MVC model migration and export configuration support
The OpenVPN configuration models have been migrated to the MVC framework, introducing new model classes (Export.php, OpenVPN.php) and XML definitions (Export.xml, OpenVPN.xml) to manage server instances, client-specific overrides, and export presets. This change adds validation logic for server directives (enforcing /29 or smaller subnets unless using p2p topology), client authentication requirements, and keepalive timing constraints. It also introduces new configuration options including DCO (Data Channel Offload) support for UDP, optional OCSP checks, route-metric pushing, and specific export features like auth-nocache, static challenge (OTP), and cryptoapi certificate loading.
src/opnsense/mvc/app/models/OPNsense/OpenVPN · high confidence
OpenVPN authentication and session management refactored to new scripts
The OpenVPN backend in src/opnsense/scripts/openvpn has been replaced with a new set of dedicated scripts to handle the full client lifecycle. Authentication is now managed by user\_pass\_verify.php, which supports deferred auth, static-challenge PIN/password handling, and group membership validation. Certificate verification is handled by tls\_verify.php, which enforces certificate depth limits and optional OCSP checks. Client connection and disconnection are now processed by client\_connect.php (which generates Client Specific Overrides) and client\_disconnect.sh (which flushes pf state). Service control, interface setup, and CARP status tracking are centralized in ovpn\_service\_control.php, while ovpn\_status.py and kill\_session.py provide modern JSON-based status reporting and session termination. A new ovpn\_event.py dispatcher routes OpenVPN events to these handlers, and genkey.py supports TLS-crypt-v2 key generation.
src/opnsense/scripts/openvpn · high confidence
OpenVPN management interface migrated to MVC
The OpenVPN administration views (Client Specific Overrides, Instances, Status, and Client Export) have been rewritten to use the MVC framework. This migration introduces a consistent UI architecture across all OpenVPN management pages, utilizing the base\_bootgrid\_table component for data grids and standardizing dialog handling. Users will see a unified interface for managing OpenVPN instances, viewing connection status, configuring client-specific overrides, and exporting client certificates, with improved responsiveness and consistent styling.
src/opnsense/mvc/app/views/OPNsense/OpenVPN · high confidence
OpenVPN management migrated to the MVC framework
The OpenVPN administration interface has been rebuilt using the MVC architecture, replacing the legacy implementation. This change introduces new API controllers for managing Client Specific Overrides, OpenVPN Instances (including static key generation), and the Client Export process, alongside a refactored Connection Status view. Users will experience improved consistency across the OpenVPN settings pages, better handling of server and client session data, and a more robust foundation for future feature additions.
src/opnsense/mvc/app/controllers/OPNsense/OpenVPN/Api · high confidence
Pluggable firmware repository scripts with subscription and auxiliary support
The firmware update mechanism now uses a pluggable script system located in src/opnsense/scripts/firmware/repos, allowing repository logic to be provided by plugins. The new OPNsense.php script handles repository configuration by supporting business mirror subscriptions (appending a subscription path to the mirror URL), selecting the appropriate firmware flavour, and enabling auxiliary repositories via the -E flag when configured. It also automatically clears the core license file if no subscription key is set, ensuring that non-subscribed users do not retain stale license data.
src/opnsense/scripts/firmware/repos · high confidence
Radvd settings and service management migrated to MVC/API controllers
The Radvd (Router Advertisement) configuration interface has been updated to use the modern MVC/API architecture. This change introduces new API controllers for managing Radvd settings and service actions, allowing users to configure router advertisements and trigger service reconfigurations through the standardized API endpoints rather than legacy mechanisms.
src/opnsense/mvc/app/controllers/OPNsense/Radvd/Api · high confidence
Radvd settings page migrated to MVC/API architecture
The Radvd (Router Advertisement) configuration interface has been refactored to use the modern MVC and API framework. The previous implementation has been replaced with a new SettingsController and Volt view that drive the UI via JSON API endpoints (e.g., /api/radvd/settings/), enabling dynamic table loading and form dialogs without full page reloads.
src/opnsense/mvc/app/controllers/OPNsense/Radvd, src/opnsense/mvc/app/views/OPNsense/Radvd · high confidence
Redesign of dashboard widgets, modals, and data tables
The Opnsense theme has been updated to improve the visual consistency and usability of the user interface. The dashboard now features a refreshed layout for widgets, including better alignment for headers and controls, along with specific styling adjustments to ensure ChartJS v4 graphs render correctly without overflow issues. Modal dialogs have been restyled with distinct header colors for different alert types (info, success, warning, danger) and include a new spinning icon animation for loading states. Additionally, the data grid component has been replaced with Tabulator, which introduces a modern table design with improved row highlighting, pagination styling, and support for grouped data and checkbox selection.
src/opnsense/www/themes/opnsense/assets/stylesheets · high confidence
Refactor NTP status page to use MVC architecture
The NTP status page has been refactored to follow the MVC pattern, replacing the previous implementation with dedicated controllers. A new ServiceController provides API endpoints for fetching NTP server status and GPS data, along with metadata definitions for server attributes and connection symbols to support the UI. A new StatusController handles the page rendering by picking the appropriate view template. This change streamlines the backend logic and aligns the NTP status display with the rest of the UI framework.
src/opnsense/mvc/app/controllers/OPNsense/Ntpd · high confidence
Refactored NTP status script to use Shell class and parse GPS data
The ntpd status script has been refactored to use the Shell class for safer command execution and to properly handle newlines in ntpq output. It now parses GPS NMEA sentences (GPRMC, GPGGA, GPGLL) to provide detailed location and satellite information, including support for SureGPS boards via GSV message parsing.
src/opnsense/scripts/ntpd · high confidence
Refactored RRD data collection types to use a new Base class and Shell integration
The RRD data collection library has been refactored to replace the previous base class with a new \OPNsense\\RRD\\Types\\Base\ class that utilizes the \Shell\ class for executing \rrdtool\ commands. This change introduces a standardized structure for system metrics, including Gateway Quality, Mbuf, Memory, NTP, OpenVPN, Packets, Processor, States, Temperature, Traffic, and Wireless types. Each type now explicitly defines its datasets (e.g., memory active/inactive/free, packet pass/block counts) and Round Robin Archive (RRA) configurations, ensuring consistent data collection and storage for system health monitoring.
src/opnsense/scripts/health/library/OPNsense/RRD/Types · high confidence
Refactored RRD statistics collection with new modular collectors
The RRD reporting infrastructure has been replaced with a new modular architecture in the \OPNsense\\RRD\ namespace. A new \Factory\ class now dynamically discovers and executes statistics collectors located in the \Stats\ directory, while a \Base\ class provides shared utilities for shell commands and system metadata. This change introduces specific new collectors for Gateway Quality, Interfaces, Mbufs, Memory (including ZFS ARC and laundry mapping), NTP, OpenVPN, Processor, States, and Temperature, replacing the previous implementation to improve maintainability and data accuracy.
src/opnsense/scripts/health/library/OPNsense/RRD/Stats · high confidence
Refactored Tunables settings to use MVC model with lazy loading
The System Settings: Tunables page has been refactored to use a new MVC-based model (TunableField) that replaces the previous implementation. This change introduces lazy loading for tunable data, meaning system sysctl values are only fetched when the settings page is actually accessed, rather than at every model load. The model consolidates tunable handling by merging static defaults and current runtime values, and it deprecates the use of the literal string 'default' for unset values in favor of empty strings. This improves performance and aligns the tunables configuration with the broader MVC migration effort.
src/opnsense/mvc/app/models/OPNsense/Core/FieldTypes · high confidence
Refactored firewall alias resolution with new parsers and async DNS
The alias resolution engine in the firewall filter scripts has been refactored into a modular library under src/opnsense/scripts/filter/lib/alias. This change introduces a new base parser architecture and specific parsers for handling various alias types, including GeoIP, BGP ASN, interface addresses, ARP cache, and authentication groups (such as OpenVPN user groups). A key behavioral improvement is the integration of an asynchronous DNS resolver, which significantly speeds up the resolution of hostnames in URL and standard aliases by batching requests. The update also adds support for parsing JSON payloads from URLs using jq, allows custom HTTP authorization headers for URL-based aliases, and improves the reliability of alias updates by preventing unnecessary disk writes and handling edge cases like time drift and missing database files.
src/opnsense/scripts/filter/lib/alias · high confidence
Removal of legacy boot configuration and device hint files
The system no longer includes the \device.hints\_wrap\ and \loader.conf\_wrap\ files, which previously provided static configuration for legacy hardware (such as ISA devices, floppy controllers, and specific ATA settings) and boot loader behavior (including console output, autoboot delays, and memory limits). Users relying on these specific hardcoded hints or loader settings will need to adjust their boot configuration through other means, as these defaults have been removed.
boot · high confidence
Removal of root shell configuration files
The root user's shell initialization files (.profile, .shrc, and .tcshrc) have been removed from the system. This change eliminates the previous behavior where interactive logins (via SSH or specific terminal types) would automatically execute /etc/rc.initial, and it removes the custom tcsh prompt, color settings, and key bindings that were previously applied to the root shell environment.
root · high confidence
Replace Phalcon MVC framework with custom OPNsense implementation
The internal MVC framework has been replaced with a custom implementation (Controller, Dispatcher, Router, Request, Response, Session, Security, Headers) to remove the Phalcon dependency. This change introduces a new routing system that normalizes path slashes and supports case-insensitive namespace resolution for backwards compatibility, while the Dispatcher now uses reflection to validate controller actions and parameters before execution. The Request class provides unified access to query, post, and raw body data, and the Response class handles JSON encoding with UTF-8 error protection and stream output cleansing. Session handling has been updated to clone data on construction to prevent locking issues, and Security now safeguards CSRF token checks against missing POST items.
src/opnsense/mvc/app/library/OPNsense/Mvc · high confidence
Replace Phalcon configuration with custom AppConfig class
The application configuration system has been refactored to remove the dependency on Phalcon's built-in configuration components. A new custom \AppConfig\ class now manages application settings, providing methods to merge configuration data and update specific properties via dot notation. The \config.php\ file now instantiates this new class with standard paths for controllers, models, views, and libraries, while \loader.php\ utilizes this configuration to register the custom autoloader.
src/opnsense/mvc/app/config · high confidence
Replaced Phalcon autoloader with a custom OPNsense implementation
The system's class loading mechanism has been updated to use a new, simplified custom autoloader located in src/opnsense/mvc/app/library/OPNsense/Autoload/Loader.php, replacing the previous Phalcon-based autoloader. This change modifies how PHP classes are discovered and loaded at runtime by iterating through configured probe directories, which may impact application startup behavior and dependency resolution within the MVC framework.
src/opnsense/mvc/app/library/OPNsense/Autoload · high confidence
Restructure early boot hooks and introduce CARP maintenance mode support
The early boot initialization sequence has been reorganized into dedicated scripts within the new rc.syshook.d/early layout. The upgrade process (05-upgrade) now explicitly handles kernel, bootloader, and package stages with immediate reboots if needed. Configuration daemon startup (10-configd) and template generation (15-templates) are separated into their own steps. A new CARP hook (90-carp) has been added to support maintenance mode: if the configuration specifies virtualip\_carp\_maintenancemode, the system forces CARP demotion to prevent premature master switching, and triggers a service status event to ensure proper state synchronization.
src/etc/rc.syshook.d/early · high confidence
Restructured High Availability XML-RPC sync and service management
The High Availability XML-RPC backend has been reorganized into modular include files (legacy.inc, service.inc, test.inc) to improve maintainability and fix synchronization behaviors. The legacy module now handles configuration merging with specific logic to preserve 'nosync' Virtual IPs during HA sync, preventing duplicate records and ensuring local VIP settings are respected. A new service module exposes functions to list, start, stop, and restart services via XML-RPC, while also reloading configuration templates. These changes refine how the secondary node applies configuration updates from the primary, particularly regarding Virtual IP handling and service state synchronization.
src/etc/inc/xmlrpc · high confidence
Restructured PHP configuration and increased memory limits
The WebGUI now uses a centralized php.ini template that increases the default memory limit to 1GB and configures session storage in a dedicated directory (/var/lib/php/sessions). This change also adjusts error reporting behavior based on the deployment mode (showing full errors in production vs. filtered errors otherwise) and sets specific upload and execution time limits to support larger operations.
src/opnsense/service/templates/OPNsense/WebGui · high confidence
Restructured bootloader configuration into modular loader chunks
The system bootloader configuration has been reorganized from a single file into a modular directory structure under /boot/loader.conf.d (exposed here as src/etc/rc.loader.d). This change introduces distinct configuration files for branding (setting the Opnsense logo and menu title), general settings (such as the autoboot delay), critical kernel modules (ensuring essential networking and firewall modules like carp, pf, and various interfaces load early to prevent race conditions), and ZFS requirements. A new banner file also informs users that custom changes should be made via loader.conf.local or the GUI to avoid being overwritten.
src/etc/rc.loader.d · high confidence
Rewritten static routing interface with apply-based configuration
The static routing management page has been rewritten to use a new MVC view structure, replacing the previous implementation. This change introduces a bootgrid-based table for managing routes and integrates a dedicated 'Apply' button that triggers a reconfiguration endpoint (/api/routes/routes/reconfigure) rather than saving changes immediately. The interface now includes specific user guidance warning against entering static routes for networks assigned to local interfaces, ensuring users only configure routes for networks reachable via different routers.
src/opnsense/mvc/app/views/OPNsense/Routes · high confidence
Router Advertisements migrated to MVC/API with new configuration options
The Router Advertisements (Radvd) settings have been migrated from the legacy configuration system to the new MVC/API architecture, introducing a dedicated menu item under Services. This change includes a migration script that automatically transfers existing DHCPv6 router advertisement settings to the new model, ensuring continuity for current users. The new configuration model adds support for NAT64 prefixes (nat64prefix), allows users to control the IPv6 hop limit (AdvCurHopLimit), and introduces options to remove advertisements and routes on exit (RemoveAdvOnExit). Additionally, a new validation field ensures that the source address for router advertisements is a valid IPv6 link-local virtual IP assigned to the selected interface.
src/opnsense/mvc/app/models/OPNsense/Radvd · high confidence
Routing configuration UI migrated to MVC Bootgrid tables
The Gateway and Gateway Groups configuration pages now use a new MVC-based interface powered by UIBootgrid tables. This change replaces the previous implementation with a standardized view structure that includes integrated search, edit, and delete actions via API endpoints (e.g., /api/routing/settings/ and /api/routing/group\_settings/). Users will see a consistent table layout with formatters for gateway status, priority, and group tier details, along with automatic handling of edit dialogs and apply buttons for reconfiguration.
src/opnsense/mvc/app/views/OPNsense/Routing · high confidence
Shaper service rewritten with new startup, synchronization, and statistics scripts
The shaper subsystem in src/opnsense/scripts/shaper has been restructured to improve reliability and performance. A new start.sh script now manages the initialization of dnctl and ipfw services, including a new sync\_fw\_hooks.py utility that ensures correct firewall hook ordering via pfilctl. The setup.sh script now explicitly configures dummynet sysctls (io\_fast, hash\_size) before module load. Additionally, a flush\_all.sh script provides a centralized way to clear ipfw rules, pipes, and queues, while update\_tables handles dynamic IP table management. The legacy rc.reload\_all PHP script has been replaced by dummynet\_stats.py, which collects and outputs current shaper statistics (pipes, queues, scheds, rules) in JSON format for the API.
src/opnsense/scripts/shaper · high confidence
Split sample file handling into distinct @sample and @shadow keywords
The package installation keywords for handling configuration sample files have been split into two distinct behaviors: @sample and @shadow. Previously, a single keyword handled both scenarios, but now @sample preserves user-modified configuration files during uninstall (removing them only if they match the original sample), while @shadow unconditionally removes the generated configuration file upon uninstall. This change allows packagers to explicitly choose whether user customizations should be preserved or cleaned up when the package is removed.
Keywords · high confidence
Standardized service management for Captive Portal, Configd, NetFlow, and Flowd Aggregate
The system now uses dedicated FreeBSD rc.d scripts to manage the lifecycle of key background services. Captive Portal is now controlled via a new rc script that handles zone bootstrapping, SSL certificate generation, and lighttpd instance management. Configd has a new rc script that ensures the Python 3 daemon starts correctly and waits for its socket to become available. NetFlow and Flowd Aggregate also gain standard rc scripts, allowing users to enable, start, stop, and check the status of NetFlow collection and flow aggregation via standard service commands. This change provides a more robust and consistent way to manage these services during system boot and shutdown.
src/etc/rc.d · high confidence
Static routes now enforce protocol matching between network and gateway
The static routes configuration now validates that the IP protocol of the selected gateway matches the network's protocol (IPv4 vs IPv6). The model enforces this by checking the gateway's IP family against the network's family, preventing mismatches such as assigning an IPv4 gateway to an IPv6 network. An exception is included to allow RFC 5549 configurations, where IPv4 traffic is routed to an IPv6 next-hop hardware address. This validation is supported by a migration script that converts existing 'disabled' flags to the new 'enabled' boolean field structure.
src/opnsense/mvc/app/models/OPNsense/Routes · high confidence
Structured local syslog filtering for individual services
The local syslog configuration has been reorganized into dedicated filter files for specific services (such as audit, configd, dhcrelay, firewall, ipsec, kea, openvpn, suricata, and wireguard). This change ensures that logs from each service are captured in their own separate log files rather than mixing into a single general log, which simplifies troubleshooting and log management for these components.
src/opnsense/service/templates/OPNsense/Syslog/local · high confidence
Support for dynamic DNS and manual SPD entries via event hooks
IPsec configuration now supports dynamic DNS scenarios by optionally hooking Virtual Tunnel Interface (VTI) setup to the connection up event. Additionally, the system introduces an event handler for manual Security Policy Database (SPD) entries when a request ID (reqid) is specified, allowing these entries to be linked to their parent connections. This is implemented through a new \reqid\_events.conf\ template that generates configuration for both SPDs and VTIs based on their enabled status and specific attributes like reqid and connection\_child.
src/opnsense/service/templates/OPNsense/IPsec · high confidence
Suricata backend scripts refactored and migrated to Python 3
The Intrusion Detection/Prevention System backend scripts in src/opnsense/scripts/suricata have been rewritten in Python 3 and restructured to use a shared rule cache. This change introduces new scripts for managing alert logs (including the ability to drop specific logs), querying alerts with filters, and listing available rulesets. The rule installation process now generates a YAML manifest of installed files and supports applying configuration changes like enabling/disabling rules or modifying actions directly during installation. Additionally, the rule updater now supports version checking to skip redundant downloads and handles required files more robustly.
src/opnsense/scripts/suricata · high confidence
Suricata configuration templates and rule management infrastructure
The Intrusion Detection System now generates its configuration files from a new set of Jinja2 templates located in the service templates directory. This change introduces structured management for Suricata, including a new \suricata.yaml\ template that supports advanced logging options such as HTTP and TLS inspection, JA4 fingerprinting, and configurable payload logging. It also adds templates for rule policies (\rule-policies.config\), rule updates (\rule-updater.config\), and user-defined rules (\OPNsense.rules\), allowing for granular control over rule actions and bypass settings. Additionally, the system now includes templates for log rotation (\newsyslog.conf\) and service startup (\rc.conf.d\), ensuring that Suricata runs correctly in IDS, IPS (netmap/divert), or pcap modes with appropriate interface bindings and logging behaviors.
src/opnsense/service/templates/OPNsense/IDS · high confidence
Suricata rule management refactored into Python modules
The Intrusion Detection/Prevention System's rule management backend has been rewritten from PHP to Python. This change introduces dedicated Python modules for downloading rules (downloader.py), parsing rule metadata (metadata.py), and managing the rule cache (rulecache.py), replacing the previous PHP-based implementation to improve maintainability and performance.
src/opnsense/scripts/suricata/lib · high confidence
Syslog destination validation and TLS support
The Syslog model now enforces stricter validation for remote logging destinations: it ensures the transport protocol (IPv4 vs IPv6) matches the address family of the specified hostname and requires a certificate when using TLS transports (tls4/tls6). Additionally, the destination configuration schema now includes TLS transport options (TLS(4) and TLS(6)) alongside existing UDP/TCP variants, allowing users to configure encrypted syslog forwarding.
src/opnsense/mvc/app/models/OPNsense/Syslog · high confidence
Syslog logging infrastructure rewritten with new Python-based tools
The syslog handling scripts in src/opnsense/scripts/syslog have been replaced with a new set of Python and PHP utilities. This introduces a new log matching engine (log\_matcher.py) that supports case-insensitive clause matching and time-constrained searches via a valid\_from parameter. A new streaming log handler (streamLog.py) enables real-time log viewing, while a lockout handler (lockout\_handler) now actively blocks IPs after failed SSH or Web GUI attempts. Log management is improved with a new archive script (log\_archive) that enforces maximum file sizes and rotation, and a certificate generation script (generate\_certs.php) now automatically manages TLS certificates for syslog destinations.
src/opnsense/scripts/syslog · high confidence
Syslog settings migration to shared model
A new migration script (M1\_0\_2) has been added to the Syslog module to automatically migrate existing local logging configuration into the new shared model structure. This ensures that current user settings for local logging enablement, maximum file size, and log preservation limits are correctly transferred during the upgrade process.
src/opnsense/mvc/app/models/OPNsense/Syslog/Migrations · high confidence
Syslog settings page restructured with new tabs and reset capability
The Syslog configuration interface has been reorganized into three distinct tabs: Local, Remote, and Statistics. The Local tab now hosts the primary settings form, while the Remote tab utilizes a bootgrid table for managing syslog destinations. A new Statistics tab displays source-level logging metrics in a read-only grid. Additionally, a 'Reset Log Files' button has been added to the Local tab, allowing users to clear all local log data after confirmation, and the remote destination configuration now supports dynamic transport type selection.
src/opnsense/mvc/app/views/OPNsense/Syslog · high confidence
Syslog source configuration updates for kernel and Unbound logs
The syslog source templates have been updated to ensure proper log collection for specific services. A new local source configuration now captures kernel messages from /dev/klog and includes the required syslog-protocol flags for Unix domain sockets to resolve RFC5424 compatibility issues on FreeBSD 12. Additionally, a new source definition for Unbound has been added to capture its logs from its specific Unix socket path, also applying the necessary protocol flags.
src/opnsense/service/templates/OPNsense/Syslog/sources · high confidence
System Trust settings now configure OpenSSL providers and protocol constraints
The System: Trust settings page now allows users to configure OpenSSL behavior directly via the new \openssl.cnf\ template. This includes enabling the legacy provider by default to support older cryptographic algorithms, and applying user-defined constraints such as minimum protocol versions, cipher suites, signature algorithms, and groups. These settings are flushed to both \/usr/local/openssl/openssl.cnf\ and \/etc/ssl/openssl.cnf\ to ensure system-wide consistency.
src/opnsense/service/templates/OPNsense/Trust · high confidence
System status checks migrated to persistent, scoped banner notifications
The system status mechanism has been refactored to use a new persistent notification framework, replacing the previous ad-hoc notices. This change introduces a suite of dedicated status classes (e.g., CaptivePortalStatus, DiskSpaceStatus, various OverrideStatus classes) that display targeted warnings or notices as persistent banners on specific UI pages. Users will now see immediate, context-aware alerts for issues such as configuration overrides in services like Unbound, IPsec, and IDS, as well as system-level conditions like live media mode, disk space thresholds, and booting states, ensuring these critical details are visible without requiring navigation to separate status pages.
src/opnsense/mvc/app/library/OPNsense/System/Status · high confidence
Traffic shaper configuration moved to the dnctl service
The system now manages traffic shaping rules via the dedicated dnctl service instead of the previous method. This change introduces a new configuration file (dnctl.conf) that generates dummynet pipe and queue definitions, including support for IPv6 masks (/128) and CIDR notation, and ensures the dnctl service starts before pf. Users will notice that shaper settings are now applied through this new service infrastructure.
src/opnsense/service/templates/OPNsense/Shaper · high confidence
Unbound DNS API controllers migrated to MVC
The Unbound DNS service API has been migrated to the MVC architecture, introducing new controllers for diagnostics, overview, service management, and settings. This change provides dedicated API endpoints for retrieving Unbound statistics and cache dumps, viewing query statistics and blocklist categories, managing DNS-over-TLS forwarders, and handling blocklist updates and host overrides, replacing the previous legacy implementation.
src/opnsense/mvc/app/controllers/OPNsense/Unbound/Api · high confidence
Unbound DNS configuration migration to new MVC model
The Unbound DNS service configuration is migrated from legacy XML nodes to the new MVC model structure. This process consolidates settings from various legacy locations—including the 'unboundplus' plugin, 'unbound' service, and 'ExtendedDnsbl' plugin—into the unified OPNsense Unbound model. Specific changes include moving domain overrides to Query Forwarding, converting host records to support RR types (A, AAAA, MX), migrating ACLs with network-based actions, merging extended blocklists into the core DNSBL system, and normalizing advanced settings like cache sizes and interface selections. Legacy configuration nodes are cleaned up after the migration to ensure a clean state.
src/opnsense/mvc/app/models/OPNsense/Unbound/Migrations · high confidence
Unbound DNS configuration templates restructured into modular components
The Unbound DNS service configuration generation has been refactored from a monolithic structure into distinct, modular configuration files (access\_lists.conf, advanced.conf, blocklists.conf, dot.conf, private\_domains.conf, safesearch.conf, and unbound\_dhcpd.conf). This change separates concerns for access control lists, advanced server settings, blocklist management, DNS-over-TLS forwarding, private domain handling, safe search enforcement, and DHCP integration. Users will see these specific configuration areas managed through their respective templates, with domain overrides migrated to the dot.conf template and blocklist sources updated to use new mirror URLs and supported lists like hagezi and Firebog.
src/opnsense/service/templates/OPNsense/Unbound · high confidence
Unbound DNS model validation and alias management
The Unbound DNS configuration model now enforces stricter validation rules and provides better alias management. Users will see validation errors if they attempt to set the DNS port to a value already in use by another service, or if they configure DNS blocklists with mixed IP protocol families (IPv4/IPv6) or inconsistent subnet sizes. Additionally, host overrides now reject hostnames ending with a trailing dot, and the system tracks alias references to prevent conflicts.
src/opnsense/mvc/app/models/OPNsense/Unbound · high confidence
Unbound DNS reporting and management scripts rewritten in Python 3 with DuckDB backend
The Unbound DNS reporting and management infrastructure in src/opnsense/scripts/unbound has been rewritten in Python 3, replacing the previous shell-based and legacy Python implementations. The new logger.py script now uses DuckDB to store query data, enabling faster analytics and persistent reporting without the CPU overhead of index maintenance. A new wrapper.py script provides a unified Python interface for querying Unbound stats, cache, and local zones, while start.sh, cache.sh, and check.sh have been updated to support the new architecture, including cache dump/load/flush capabilities and improved error handling. The blocklists.py script introduces a structured command-line interface for managing blocklist policies, and unbound\_watcher.py has been refactored to use Python's subprocess and daemonize libraries for more robust DHCP lease monitoring.
src/opnsense/scripts/unbound · high confidence
Unbound DNS settings pages migrate to MVC controllers
The Unbound DNS configuration interface has been migrated from the legacy PHP-based architecture to the MVC framework. This change introduces dedicated controllers for each settings section—General, Advanced, ACLs, Overrides, DNSBL, DoT, Forwarding, Stats, and Overview—ensuring a consistent, modern user experience for managing DNS resolution, access control, and reporting.
src/opnsense/mvc/app/controllers/OPNsense/Unbound · high confidence
Unbound DNS views migrated to MVC architecture
The Unbound DNS configuration and reporting pages (General, Advanced, ACLs, Overrides, DNSBL, DoTLS, Overview, and Stats) have been converted to the MVC view layer. This migration replaces the legacy PHP-based interface with Volt templates and modern JavaScript, introducing consistent UI components like the Bootgrid table for data grids, unified apply buttons, and dynamic form handling via API endpoints. Users will experience a more responsive interface with improved styling, better handling of master/detail relationships (such as host overrides and aliases), and standardized service control widgets across all Unbound sub-pages.
src/opnsense/mvc/app/views/OPNsense/Unbound · high confidence
Unbound DNS: New interface and alias field types for MVC migration
The Unbound General page now uses new MVC field types to improve configuration handling. The UnboundInterfaceField now explicitly includes OpenVPN interfaces in the interface selection list, allowing users to bind Unbound to these virtual interfaces. Additionally, the new AliasReflector field type manages host aliases by splitting host/domain names and synchronizing changes directly with the underlying alias configuration, ensuring that adding or removing aliases in the Unbound settings updates the global alias list correctly.
src/opnsense/mvc/app/models/OPNsense/Unbound/FieldTypes · high confidence
Unbound DNSBL module refactored into Python with improved policy matching and logging
The Unbound DNSBL library has been rewritten in Python, replacing the previous PHP-based configuration sync script. This change introduces a new \Query\ class to safely parse DNS request and response states, and a \DNSBL\ class that handles dynamic blocklist loading and policy matching. A key behavioral improvement is the disabling of caching for domains that match a blocklist policy, ensuring that queries from different source networks are correctly evaluated against their specific rules. Additionally, a new \Logger\ class manages query logging via a named pipe, buffering entries when the backend is unavailable, while utility functions provide safer object path traversal.
src/opnsense/scripts/unbound-dnsbl/lib · high confidence
Unbound blocklist processing restructured with caching and wildcard support
The Unbound DNS blocklist handling has been refactored to improve reliability and flexibility. The system now caches downloaded blocklists locally to reduce network load and speed up processing, while also supporting wildcard domain entries in blocklists. Additionally, whitelist (passlist) management has been moved from a pre-filtering option to a dedicated plugin-based handler, allowing for more granular control over which domains are excluded from blocking rules.
src/opnsense/scripts/unbound/blocklists · high confidence
Updated Captive Portal default login template to Bootstrap 3.4.1
The default Captive Portal login page now uses Bootstrap v3.4.1 instead of v3.3.5. This update brings the latest styling, component fixes, and glyph icons to the captive portal interface, ensuring a more consistent and modern look for users authenticating on the network.
_src/opnsense/scripts/captiveportal/htdocs\default · high confidence
Updated IXR XML-RPC library to version 1.7.4
The contrib/IXR/IXR\_Library.php file has been replaced with version 1.7.4 of the Incutio XML-RPC Library. This update addresses PHP 8 compatibility issues, specifically correcting the constructor format and resolving deprecation warnings related to non-canonical type casts (double, boolean) and the count() function. It also removes unnecessary trimming of XML values and replaces the deprecated curl\_close() usage, ensuring stable operation of High Availability status checks and other XML-RPC dependent features on modern PHP versions.
contrib/IXR · high confidence
Updated OPNsense package repository fingerprint for 2026-06-08
The trusted fingerprint file for the OPNsense package repository has been updated to reflect the correct SHA-256 hash for the 2026-06-08 release. This change corrects a previous error where the 26.7 fingerprint was incorrectly copied from the 26.1 release, ensuring that package verification uses the accurate cryptographic signature for the current software version.
src/etc/pkg/fingerprints/OPNsense/trusted · high confidence
Updated Unbound root hints to December 2023
The Unbound DNS resolver now uses a fresh copy of the root hints file (root.min.hints) updated as of December 20, 2023. This ensures the resolver has the latest authoritative root server addresses, which can improve DNS resolution reliability and performance by reducing reliance on potentially stale cached root server information.
src/opnsense/data/unbound · high confidence
Updated bootstrap-select styling assets
The LESS source files for the bootstrap-select component have been updated to version 1.9.3, introducing new styling rules for dropdown toggles, error states, and disabled interactions, along with updated variable definitions for colors and z-indexing to ensure proper layering with modals and the navbar.
src/opnsense/www/themes/opnsense/assets/stylesheets/bootstrap-select · high confidence
Updated revoked package signing fingerprints for pkg.opnsense.org
The revoked fingerprint list for the OPNsense package repository has been updated with 21 new entries spanning from 2015 to 2026. These additions record historical SHA-256 keys that are no longer valid, ensuring the system correctly rejects packages signed with obsolete credentials during updates.
src/etc/pkg/fingerprints/OPNsense/revoked · high confidence
Upgrade Font Awesome icons to version 6
The Font Awesome icon library in the web interface has been upgraded from version 5 to version 6.7.1. This update replaces the previous icon set with new styles, animations, and a broader range of icons, which may alter the appearance of existing UI elements and require updates to icon class names in custom themes or scripts.
src/opnsense/www/assets · high confidence
Upgrade sanity checks for package manager compatibility
A new pre-upgrade sanity check script (10-sanity.sh) has been added to the upgrade process to verify the system's readiness before proceeding. This script ensures that the core package name can be determined, the package manager (pkg-static) is installed, the core package is recognized by the package database, and the package manager is compatible with the OPNsense product. If any of these checks fail, the upgrade process will halt with a descriptive error message, preventing potential issues during the upgrade.
src/etc/rc.syshook.d/upgrade · high confidence
WireGuard API refactoring and client configuration enhancements
The WireGuard API controllers have been restructured into dedicated modules (Client, Server, General, Service) to improve code organization. This change introduces new capabilities for managing client configurations, including a new API endpoint to generate pre-shared keys and a client builder feature that allows generating client configuration files while automatically storing the public keys on the firewall. The service controller now handles interface registration and reconfiguration more robustly, and the status display logic has been updated to correctly identify peers by name even when public keys overlap between different instances, as well as to track peer online/offline status based on handshake age.
src/opnsense/mvc/app/controllers/OPNsense/Wireguard/Api · high confidence
WireGuard diagnostics and configuration UI enhancements
The WireGuard interface now includes a dedicated diagnostics view that displays a unified grid of both VPN instances and peers, allowing users to filter by type and monitor real-time status (Online/Offline/Stale), handshake ages, and data transfer volumes. In the general configuration view, the peer generator has been improved with a server filter to select the target instance, and key generation buttons for both server keypairs and client pre-shared keys have been moved directly into their respective forms for easier access.
src/opnsense/mvc/app/views/OPNsense/Wireguard · high confidence
WireGuard interface restructured with dedicated controllers and diagnostics
The WireGuard management interface has been refactored to use dedicated MVC controllers for general settings and diagnostics. The new GeneralController now explicitly loads forms for both WireGuard servers and clients, including a new 'Config Builder' dialog that allows users to generate client configuration files and store their public keys on the firewall. A new DiagnosticsController has been added to provide a separate diagnostics view, while the GeneralController also integrates QR code generation libraries to facilitate client configuration sharing.
src/opnsense/mvc/app/controllers/OPNsense/Wireguard · high confidence
WireGuard model schema restructured with mandatory network masks and peer generator storage
The WireGuard configuration models have been updated to enforce stricter validation and support new client-side features. The \Client\ model now includes fields for storing peer generator output (private key, endpoint, DNS, and allowed IPs) and enforces a unique constraint on the public key relative to the server address and port. A new \M1\_0\_0\ migration automatically appends \/32\ or \/128\ netmasks to existing tunnel addresses to satisfy the new \NetMaskRequired\ validation, ensuring compatibility with FreeBSD 15. The \Server\ model now allows instance IDs to start at 0 and includes a debug flag for logging.
src/opnsense/mvc/app/models/OPNsense/Wireguard · high confidence
WireGuard server configuration template added
A new Jinja2 template for generating WireGuard server configuration files has been introduced. This template iterates through defined server instances and their associated peers, outputting the standard \[Interface\] and \[Peer\] sections including private keys, listen ports, preshared keys, endpoints, allowed IPs, and persistent keepalive settings. This change establishes the mechanism for rendering the active WireGuard server configuration on the firewall.
src/opnsense/service/templates/OPNsense/Wireguard · high confidence
configd action execution engine refactored to use a plugin-based architecture
The configd service now uses a new ActionFactory to dynamically load and execute actions, replacing the previous monolithic implementation. This change introduces distinct action types—inline (for template management and config lookups), script (for standard command execution), script\_output (for cached script results), stream\_output (for real-time output streaming), and none (for unknown types)—each inheriting from a common BaseAction. Users benefit from improved reliability through better error handling, support for caching script outputs via cache\_ttl, and the ability to stream long-running process output directly to the client.
src/opnsense/service/modules/actions · high confidence
configd backend service rewritten with new template engine and modular architecture
The configd service module has been restructured into a modular Python package, introducing a new Jinja2-based template engine for generating configuration files and a refactored daemon handler for processing commands via Unix domain sockets. This change adds support for advanced template features such as IDNA encoding, shell parameter escaping, and strict mode targeting, while also improving error reporting, logging, and session context handling for the backend service.
src/opnsense/service/modules · high confidence
configd service and control tools rewritten in Python 3
The configd process coordinator and its command-line utilities (configd\_ctl.py, template\_ctl.py) have been rewritten from PHP to Python 3. This change introduces a new daemon wrapper (configd.py) that automatically restarts the service if it crashes unexpectedly, and updates the client tools to use a Unix domain socket for communication. Users benefit from improved stability through automatic restarts, better handling of event handlers, and the ability to flush command caches or detach long-running actions via new command-line flags.
src/opnsense/service · high confidence
Fixes
Fix IPsec SPD rule detection and permission issues
This change introduces a new library module for parsing IPsec Security Policy Database (SPD) entries, correcting a regression in automatic rule detection and adding support for manual entries with specific request IDs. It also addresses a permission issue within the IPsec script library to ensure proper execution context.
src/opnsense/scripts/ipsec/lib · high confidence
Test coverage
1 commit adding/updating tests in src/opnsense/mvc/tests/app/models/OPNsense/CaptivePortal; 2 commits adding/updating tests in src/opnsense/mvc/tests/app/models/OPNsense/Interfaces; Added migration test fixtures for BaseModel; Added test configuration for OPNsense MVC application; Added unit tests for BaseModel validation constraints; Added unit tests for Core Config and Shell utilities; Added unit tests for Dnsmasq HostnameField validation; Added unit tests for FilterRule generation; Added unit tests for IPv6 track6 prefix ID and delegation logic; Added unit tests for Kea DHCP option data field encoding; Added unit tests for MVC Base Field Types; Added unit tests for Unbound DNSBL script components; Added unit tests for field comparison and uniqueness constraints; Added unit tests for firewall alias parsers; Added unit tests for the ACL model; Initial PHPUnit test framework setup for MVC components; Initial unit tests for configd core and template modules; Initial unit tests for the BaseModel class.
Housekeeping
Placeholder file added to CARP service status directory
A placeholder file has been added to the src/etc/rc.carp\_service\_status.d directory, replacing a previously located file in cf/conf/trigger\_initial\_wizard. This change appears to be a structural adjustment to the directory layout rather than a functional update to the CARP service status logic itself.
_src/etc/rc.carp\_service\status.d · low confidence
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
How this codebase got here
Score
- CAI 30.4 → 32.2 (+1.8)
- Rubric changed (rubric-2026.11.2 → rubric-2026.11.4) — scores are not directly comparable.
Lenses
- Code Health 31.6 → 29.5 (-2.1)
- Architecture 88.6 → 89.8 (+1.2)
- Maturity 58.8 → 62.8 (+4.0)
- Readiness 18.8 → 22.9 (+4.1)
- Security 63.4 → 63.4 (0.0)
- Accessibility 27.9 → 27.5 (-0.4)
- Performance 100.0 → 100.0 (0.0)
Resolved (44)
- ACL.hasPrivilege (cognitive 32) (src/opnsense/mvc/app/models/OPNsense/Core/ACL.php)
- Change coupling: ArchiveOpenVPN.php ↔ ViscosityVisz.php (src/opnsense/mvc/app/library/OPNsense/OpenVPN/ArchiveOpenVPN.php)
- Duplicated block (11 lines × 2) (src/opnsense/mvc/app/controllers/OPNsense/Interfaces/Api/GifSettingsController.php)
- Duplicated block (12 lines × 3) (src/opnsense/mvc/app/controllers/OPNsense/Interfaces/Api/GifSettingsController.php)
- Duplicated block (12–13 lines × 2) (src/opnsense/mvc/app/controllers/OPNsense/Core/Api/FirmwareController.php)
- Duplicated block (13 lines × 2) (src/opnsense/mvc/app/library/OPNsense/System/Status/MonitOverrideStatus.php)
- Duplicated block (26 lines × 3) (src/opnsense/mvc/app/controllers/OPNsense/IPsec/Api/ManualSpdController.php)
- Duplicated block (26 lines × 4) (src/opnsense/mvc/app/controllers/OPNsense/IPsec/Api/ManualSpdController.php)
- Duplicated block (27 lines × 2) (src/opnsense/mvc/app/models/OPNsense/Firewall/FieldTypes/AliasNameField.php)
- Duplicated block (32 lines × 3) (src/opnsense/mvc/app/controllers/OPNsense/Interfaces/Api/LoopbackSettingsController.php)
- Duplicated block (5 lines × 2) (src/opnsense/mvc/app/models/OPNsense/Cron/Migrations/M1_0_2.php)
- Duplicated block (5 lines × 2) (src/opnsense/mvc/app/models/OPNsense/IDS/Migrations/M1_0_7.php)
- Duplicated block (5 lines × 2) (src/opnsense/scripts/captiveportal/cp-background-process.py)
- Duplicated block (5 lines × 2) (src/opnsense/scripts/captiveportal/lib/init.py)
- Duplicated block (5 lines × 2) (src/opnsense/scripts/health/library/OPNsense/RRD/Stats/Interfaces.php)
- Duplicated block (5 lines × 2) (src/opnsense/scripts/wireguard/wg-service-control.php)
- Duplicated block (5 lines × 3) (src/opnsense/mvc/app/controllers/OPNsense/Firewall/DNatController.php)
- Duplicated block (6 lines × 2) (src/opnsense/mvc/app/controllers/OPNsense/Syslog/IndexController.php)
- Duplicated block (6 lines × 2) (src/opnsense/mvc/app/library/OPNsense/Auth/AuthenticationFactory.php)
- Duplicated block (6 lines × 2) (src/opnsense/mvc/app/library/OPNsense/Auth/Radius.php)
- …and 24 more
New (100)
- ACL.get (cognitive 20) (src/opnsense/mvc/app/models/OPNsense/Core/ACL/ACL.php)
- ACL.getUserAuthorities (cognitive 47) (src/opnsense/mvc/app/models/OPNsense/Core/ACL.php)
- ACL.getUserAuthorities (cyclomatic 18) (src/opnsense/mvc/app/models/OPNsense/Core/ACL.php)
- Duplicated block (26 lines × 4) (src/opnsense/mvc/app/controllers/OPNsense/IPsec/Api/ManualSpdController.php)
- Edited copies of one member (3 members, 3+ corresponding lines) (src/opnsense/mvc/app/controllers/OPNsense/Firewall/Api/CategoryController.php)
- Edited copies of one member (3 members, 3+ corresponding lines) (src/opnsense/mvc/app/models/OPNsense/Base/FieldTypes/BaseListField.php)
- Edited copies of one member (3 members, 5+ corresponding lines) (src/opnsense/mvc/app/controllers/OPNsense/Interfaces/Api/VipSettingsController.php)
- Edited copies of one member (3 members, 7+ corresponding lines) (src/opnsense/mvc/app/controllers/OPNsense/Interfaces/Api/LoopbackSettingsController.php)
- Edited copies of one member (3 members, 7+ corresponding lines) (src/opnsense/mvc/app/models/OPNsense/Base/Validators/IntegerValidator.php)
- Edited copies of one member (3 members, 9+ corresponding lines) (src/opnsense/mvc/app/controllers/OPNsense/Routes/Api/RoutesController.php)
- Edited copies of one member (3 members, 9+ corresponding lines) (src/opnsense/mvc/app/controllers/OPNsense/TrafficShaper/Api/SettingsController.php)
- Edited copies of one member (3 members, 9+ corresponding lines) (src/opnsense/mvc/app/models/OPNsense/Firewall/Migrations/MFP1_1_1.php)
- Edited copies of one member (3 members, 9+ corresponding lines) (src/opnsense/scripts/syslog/logformats/init.py)
- Edited copies of one member (4 members, 14+ corresponding lines) (src/opnsense/mvc/app/models/OPNsense/Auth/FieldTypes/UsernameField.php)
- Edited copies of one member (4 members, 7+ corresponding lines) (src/opnsense/mvc/app/models/OPNsense/Firewall/Migrations/MFP1_1_0.php)
- Edited copies of one member (8 members, 5+ corresponding lines) (src/opnsense/mvc/app/library/OPNsense/System/Status/CaptivePortalStatus.php)
- Edited copy of a member (10 corresponding lines) (src/opnsense/mvc/app/controllers/OPNsense/Diagnostics/Api/NetworkinsightController.php)
- Edited copy of a member (10 corresponding lines) (src/opnsense/mvc/app/controllers/OPNsense/Interfaces/Api/GifSettingsController.php)
- Edited copy of a member (10 corresponding lines) (src/opnsense/mvc/app/models/OPNsense/Base/FieldTypes/IntegerField.php)
- Edited copy of a member (10 corresponding lines) (src/opnsense/scripts/captiveportal/lib/daemonize.py)
- …and 80 more
Changes since last survey
- 65 commits — 55 feature/other, 10 fixes
By area
- src/opnsense — 51 commits
- src/etc — 10 commits
- (root) — 1 commit
- Mk/git.mk — 1 commit
- contrib/ieee — 1 commit
- src/www — 1 commit
Notable commits
- fix: Interfaces: Assignments - patch incomplete fix in https://github.com/opnsense/core/commit/b39a7a958669319560e0c4fffe6cda74e01e4f70, which triggers all interfaces as changed.
- fix: Services: Captive Portal - partially revert https://github.com/opnsense/core/commit/2bb88a77bdc6643174e10ab1f3ae59cdf0b30b8f for https://github.com/opnsense/core/issues/11214
- fix: Services: Unbound DNS: Blocklists - fix regression in https://github.com/opnsense/core/commit/09f40f0e335abec865c708046db134d4dcacc8a6, closes https://github.com/opnsense/core/issues/11168
- fix: System: Routes: fix regression in https://github.com/opnsense/core/commit/af3ae76ce8b0fd9bd74ab86be4f74967ef2d0710 to slightly refactor syncRoutes()
- fix: filter: fix alias cleanup for external aliases (#11162)
- fix: firewall: fix alias edit links and scope it down to valid uuids only (#11195)
- fix: interfaces: reports say 26.8.9 fixed this which may have been a kernel issue
- fix: ipsec: fix deprecation error
- fix: system: fix Norwegian/Vietnamese not being translated
- fix: system: fix automation user scope set since validation was tightened; closes #11192
- change: Captive Portal: Make zone id a text field and constrain it to be unique. (#11190)
- change: Firewall: Aliases - remove unused "EU" workaround (Maxmind seems to have removed these entries) and add Kosovo which isn't in IANA's list. closes https://github.com/opnsense/core/issues/11210
- change: Firewall: Rules - replyto/routeto validation, closes https://github.com/opnsense/core/issues/11199
- change: Firewall: log parsing, properly skip records like "Last message..." for https://github.com/opnsense/core/issues/11213
- change: IPsec: Pre-Shared Keys - check uniqueness when only the remote identifier changes (#11224)
- change: Interfaces: Assignments - during reconfiguration, an event could be triggered which will then use the current configuration data instead of the state if should have when finished. (ref: https://github.com/opnsense/core/pull/11178)
- change: Interfaces: Devices: Point-to-Point - extend line ending validation to other fields as well.
- change: Interfaces: Hostwatch: Add async pf state information as statistics column, with link to states per host (#11180)
- change: Remove deprecated blocklist entries (#11212)
- change: Routing: Gateways - drop threshold constraints that never ran (#11225)
- …and 45 more
Architecture
- Unchanged — 0 containers · 1 contexts · 0 edges
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
Survey your own repository
opnsense/core was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.
About this page
- The score is its most recent published measurement, taken on 17 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
- Measured at commit 16441d3fff9b9a13d18a855e3f29defb0fa338ea — the exact code this score is about.
- Scored under rubric-2026.11.4 — the same rubric and the same method as every other entry in this index.
- Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.85+preprod-eba6548ac50f.