OPNsense is an open source community project that depends on your contributions for its continuing development & success.
There are plenty of opportunities to contribute and help OPNsense reach its goal of becoming the most widely used open source security & firewall platform. Financial contributions are always welcome and will allow us to develop parts of the system that may otherwise stay untouched.
The OPNsense core team wants to thank everyone who contributed already.
“An open source project can only thrive by the community around it.” We are grateful of all the kind words and support the users of OPNsense are giving us.
Frequently users ask us how they can contribute to the project. To make the software better we need your involvement in testing and providing feedback and if you can spare a few bucks that would be great.
To enable us to continue development and keep on improving the project you can contribute by donating to the project, this a simple non recurring - no strings attached - way of supporting the project. Any amount will be gratefully accepted!
The OPNsense project offers a partner program where businesses receive project benefits while supporting the project financially.
Main benefits include:
- Listing on our OPNsense partner page
- Access to the core team
To get enlisted as partner of the OPNsense project means a minimum annual investment of € 2500.Partners that made an exceptional contribution to the project are assigned the Platinum Partner status.
Contributing to the ongoing development of OPNsense can be done by:
- Testing a development version and
- Report issues and/or
- Help fixing issues as well as by
- Contributing new functionality
- Share your code with the project by manner of a pull request.
Before you send in your pull request, please read our Coding Guidelines and see the community support levels in the Support Options. It is important for plugin developers to maintain their plugin and interact with users for QA.
Contribute by testing the latest development version to make the next release even better than the last. If you like to test a development version then the easiest way is to login to the console and type:
pkg install -y opnsense-devel
And to revert back to the production version:
pkg install -y opnsense
That is all there is to it to test the latest development release. Development releases are usually built at the same day the latest production release comes available.
Reporting an issue¶
Issues can be easily reported on github, please consider carefully if the issue could be a configuration or user error before reporting it. If you are unsure, report you issue on the Forum or on IRC/Freenode (#opnsense).
If you are a programmer or just know how to fix a certain issue then you can help by either sharing your ideas on or send in a pull request on github.
Designing new features¶
If you like to help designing new features then start with reading the Development manual and checkout our roadmap as well as our issue tracker. Before starting it is always a good to share your idea first with a core developer, to do so you can use either:
OPNsense has an active translation project, currently supporting:
- Simplified Chinese
Working on translations is time consuming, but if you feel up to it and would like to help adding another language, then please contact us via email (contact @ opnsense.org).
Documentation & wiki articles¶
The easiest way to help with documentation is to write how-to type articles. As the wiki & documentation project itself is written in reStructuredText you can offer your content in this format (preferably as pull request), but other formats are also possible, such as:
- markup with ./images/directory including the used images(in any)
- word document with embedded images (if any)
To include you documentation send it to contact @ opnsense.org. Make sure that:
- Your content does not include copyrighted material if you do not own the copyright yourself
- State that we may use the content under our Documentation Copyright as listed in the Legal notices section.
Forum & IRC¶
If you have suggestions on how others can contribute to OPNsense and it is not yet listed on this page, then let us know. You can reach us at contact @ opnsense.org.