Managing Patch Entries

Manage patch entries at System > Patches.

The Custom System Patches list is for patches added manually by firewall administrators. The list has the following functions:

Select/Move:

Selects entries to move or delete.

Clicking the icon moves selected patches to this position, altering the order of patches. This may be relevant with auto-apply if one patch depends upon another.

Description:

Text describing the patch, for reference.

Fetch:

A button to download the patch content from its source, either a custom URL or a GitHub commit ID.

Apply:

Attempt to apply this patch.

Revert:

Attempt to revert this patch.

View:

View the contents of the patch data.

Debug:

Test the patch and interpret the results, this will display information about why a patch may not apply or restore cleanly. The output will include a detailed analysis of the results and can optionally display full detail of patch failures.

Auto Apply:

A read only indication of whether this patch entry has the auto-apply option enabled.

Edit:

The icon edits this patch entry.

Delete:

The icon deletes this patch entry.

Add New Patch:

Creates a new patch entry.

Delete Patches:

Deletes all selected patch entries.

Note

The GUI does not display buttons unless they are relevant.

The lower section contains Recommended System Patches for the specific running version of pfSense software as described earlier in this document under Recommended System Patches. The controls in this section are limited as there is no need to edit the entries or alter the list.

Warning

There is typically no need to revert Custom or Recommended patch entries before or after upgrading pfSense software. Newer releases may contain the same fix as an older patch, which means the patch may appear to be applied after upgrading. Reverting such patches will remove the fix from the new release, bringing back the old bug. As such, the best course of action is to delete outdated Custom System Patch entries without reverting them.