Skip to content

Software Policies

A software policy is a named list of OPNsense plugins and FreeBSD packages, each marked Present or Absent. Attach the policy to a template and NetDefense installs or uninstalls the matching packages on every device that template reaches during the next sync. Read the conceptual model in Software Policies.

The Software policies page: two policies, each with its Present, Absent, Repos and External counts and when it was updated

Each row is one policy:

ColumnMeaning
NameClick to open the policy.
PresentNumber of packages the policy requires: they must be installed.
AbsentNumber of packages the policy blocks: they must be removed.
ReposNumber of custom package repositories the policy adds.
ExternalNumber of external packages the policy installs from a URL.
UpdatedWhen the policy or its package list was last changed.

Each row’s … menu has Open and Delete.

+ New policy in the top-right asks for a name and creates the policy empty. On the policy’s own page, you mark packages as required (Present) or blocked (Absent) by their FreeBSD package or OPNsense plugin name. You can also add custom repositories, which the device gets before any package work, and external packages, installed from a URL for software no repository serves. Rename and Delete are at the top of that page.

Once saved, the policy is inert until you attach it to a template, from the Software Policies card on the template’s page. When a device synchronises with a template that includes a software policy, NDAgent computes the diff between what’s installed locally and what the policy declares, then installs or removes packages to converge. Failures surface as failed tasks on the device’s history.

Policies are organization-scoped, so the same list can be reused across multiple templates without duplication.