OPNsense Forum

English Forums => General Discussion => Topic started by: 300cpilot on January 10, 2026, 05:11:16 PM

Title: Plugin developement question
Post by: 300cpilot on January 10, 2026, 05:11:16 PM
I am developing a plugin for OpnSense. I have looked through doc's and searched the forum. I would like to hear from anyone that has done it. Really looking for what issues you encountered. I believe it would be a long time before, if ever, it would be available. This is more for my use only for now.
Title: Re: Plugin developement question
Post by: Monviech (Cedrik) on January 10, 2026, 05:50:04 PM
Got any specific questions? Generally the issues depend on the complexity of whats trying to be accomplished.

I developed quite some things for opnsense by now, plugins and core features.
Title: Re: Plugin developement question
Post by: 300cpilot on January 11, 2026, 01:21:09 AM
Upgrades, how far in advance are beta updates to the production version released by Opnsense, ? If I under take this, I would like to maintain it as well in a timely manor. I'm one guy so if this is to short, it may kill my idea.

Future questions:
Is there documentation on the official process for getting them put in the Plugin list? I have never been involved with an open source project before so I'm testing new waters. https://docs.opnsense.org/manual/software_included.html#plugins Does not give a lot of details on the process.

What the project is:
I would like to line it all out, but someone more familiar would push this out a lot faster than myself, so I am going to keep it to myself for a while yet.I'm sure I will let the cat out of the bag soon enough.

Many Thanks!
Title: Re: Plugin developement question
Post by: Monviech (Cedrik) on January 11, 2026, 07:56:09 AM
If you are concerned about changes in code, if you run the "Development" version (System - Firmware... change it there), you will always be pretty close to master. The "Community" version lags behind a bit and sometimes features or changes are withheld until the next major version. Major releases are all 6 months and can be seen here: https://opnsense.org/roadmap/

To get a plugin into the plugin list create a PR here: https://github.com/opnsense/plugins

To get it in,
- it should be generally useful (meaning if its something purpose built for just your own personal usecase it might not make it). Though please offer it, who knows if its not generally useful without seeing it
- It should be based on an existing FreeBSD port (no "business" logic inside the plugin, only glue code)

If you need a current example that shows all of this:
https://github.com/opnsense/plugins/tree/master/net/ndp-proxy-go