You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Go to file
Ad Schellevis 0f558cd90f changlogs 1 day ago
.github/ISSUE_TEMPLATE add issue templates 3 years ago
source changlogs 1 day ago
.gitignore add script to collect and transform release logs. 4 years ago add 3 years ago
LICENSE Many typo fixes and some rewording (#80) 6 years ago
Makefile Makefile: use all available cores by default 10 months ago Update (#544) 2 months ago extend script with support for abstract classes, add used model when using standard templates. 4 years ago support - add list of supported community plugins and their tier including a script to collect them 1 year ago fix links (and code responsible for generating) 5 months ago support - add list of supported community plugins and their tier including a script to collect them 1 year ago
requirements.txt sphinx_rtd_theme==0.5.2 << version 1.0.0 doesn't render correctly 3 years ago

alt text

OPNsense documentation

Welcome to the OPNsense documentation & wiki.
The purpose of this project is to provide OPNsense users with quality documentation.


You can contribute to the project in many ways, e.g. testing functionality, sending in bug reports or creating pull requests directly via GitHub. Any help is always very welcome!


OPNsense documentation is available under the 2-Clause BSD license:

Every contribution made to the project must be licensed under the same conditions in order to keep OPNsense truly free and accessible for everybody.

Some pictures are licensed under the Creative Commons Zero (CC0) license:

Logos may be subject to additional copyrights, property rights, trademarks etc. and may require the consent of a third party or the license of these rights. Deciso B.V. does not represent or make any warranties that it owns or licenses any of the mentioned, nor does it grant them.

Prepare build

On FreeBSD the following packages are required:

pkg install py39-pip jpeg-turbo gmake

Install Sphinx, our default theme and contrib packages:

pip[3] install -r requirements.txt --upgrade

Update API endpoints

A script is provided to update the api endpoint documentation, this can be executed using:

./ --repo core /path/to/core/repository
./ --repo plugins /path/to/plugins/repository

Generate HTML documents

make html

(make clean to flush)

Live preview of HTML documents

Use sphinx-autobuild to track source for changes and get a live preview served via http://localhost:8000.

pip[3] install sphinx-autobuild
sphinx-autobuild source html