Boot-Notice „Generating configuration: templates...failed“

[nodea]

Hallo,

nach einem Upgrade von OPNsense 25.7.11_9 auf 26.1.3 ist mir beim Booten folgende Meldung aufgefallen:

Code Select Expand

Generating configuration: templates...failed

Die Meldung erscheint in dmesg bzw. unter System → Log Files → General.

Nach etwas Debugging stellte sich heraus, dass das Problem durch das Beispiel-Template:

Code Select Expand

/usr/local/opnsense/service/templates/OPNsense/Sample

verursacht wurde.

Im Log (/var/log/configd/latest.log) findet sich dazu ein Traceback:

Code Select Expand

jinja2.exceptions.UndefinedError: 'filter' is undefined
File ".../templates/OPNsense/Sample/example_simple_page.txt"

Das Sample-Template enthält Code wie:

Code Select Expand

{% for item in filter.rule %}
Beim normalen Boot-Template-Rendering scheint das Objekt "filter" jedoch nicht im Template-Kontext vorhanden zu sein, wodurch die Generierung fehlschlägt.

Workaround:
Das Verschieben oder Entfernen des Sample-Templates behebt das Problem sofort:

Code Select Expand

mv /usr/local/opnsense/service/templates/OPNsense/Sample /backup/_DISABLED/

Danach wird beim Booten korrekt gemeldet:

Code Select Expand

grep templates /var/log/system/latest.log
<13>1 2026-03-05T13:10:12+01:00 opnsense.space.lan kernel - - [meta sequenceId="210"] <118>[7] >>> Invoking early script 'templates'
<13>1 2026-03-05T13:10:12+01:00 opnsense.space.lan kernel - - [meta sequenceId="211"] <118>[7] Generating configuration: templates...done

Da es sich offenbar nur um ein Entwickler-/Beispieltemplate handelt, stellt sich die Frage, ob dieses überhaupt auf Produktionssystemen installiert werden sollte bzw. ob das Template defensiver implementiert werden sollte (z.B. mit ,,if filter is defined").

Vielleicht hilft der Hinweis anderen Nutzern, die nach einem Upgrade plötzlich diese Bootmeldung sehen.

Viele Grüße
/nodea