mirror of https://github.com/opnsense/docs
add some documentation about included software, closes https://github.com/opnsense/docs/issues/174
parent
ddd81c2bca
commit
12a1845d47
@ -0,0 +1,83 @@
|
|||||||
|
=======================
|
||||||
|
Included software
|
||||||
|
=======================
|
||||||
|
|
||||||
|
OPNsense® comes with a lot of features included in the base system, for some situations you may need additional software, which
|
||||||
|
is either provided via a plugin or only as a binary package (without user interface).
|
||||||
|
|
||||||
|
This chapter aims to provide some details on the components included in the system, where to find them and how to
|
||||||
|
install them when not installed by default.
|
||||||
|
|
||||||
|
|
||||||
|
The operating system
|
||||||
|
....................................
|
||||||
|
|
||||||
|
The basic ( `HardenedBSD <https://hardenedbsd.org/>`__) system contains a kernel and a base package, which provide the
|
||||||
|
bare essentials for the system to be able to boot and do its work.
|
||||||
|
|
||||||
|
Both components are updated using :code:`opnsense-update`, which is explained in more detail
|
||||||
|
`here <https://docs.opnsense.org/manual/opnsense_tools.html#opnsense-update>`__.
|
||||||
|
|
||||||
|
|
||||||
|
Plugins
|
||||||
|
....................................
|
||||||
|
|
||||||
|
Plugins are packages offered by OPNsense®, which can be installed directly via the user interface and often come
|
||||||
|
with setup options accessible for the end-user.
|
||||||
|
|
||||||
|
Since OPNsense® is a community driven project, the amount of (community/commercial) support available on these plugins
|
||||||
|
can be different.
|
||||||
|
|
||||||
|
.. Note::
|
||||||
|
|
||||||
|
The plugin repository is maintained by the project, when plugins are not kept up to date by its maintainer, they will
|
||||||
|
be removed at some point in time.
|
||||||
|
(a good example for such a plugin would be if one requires python 2 and we stop shipping it due to upstream deprecation)
|
||||||
|
|
||||||
|
|
||||||
|
Packages (pkg)
|
||||||
|
....................................
|
||||||
|
|
||||||
|
Binary software is installed using pkg, which uses our software repository (available via multiple mirrors).
|
||||||
|
All installed software can be found via the user interface :menuselection:`System -> Firmware ->Packages`, but in some situations
|
||||||
|
people want to install additional software via the command line of the machine itself.
|
||||||
|
|
||||||
|
To find a full list of all software available, you can use the following command:
|
||||||
|
|
||||||
|
.. code-block:: sh
|
||||||
|
|
||||||
|
pkg info
|
||||||
|
|
||||||
|
|
||||||
|
If, for example you would like to install the gnu `nano <https://www.nano-editor.org/>`__ editor, you can do so using the following command:
|
||||||
|
|
||||||
|
.. code-block:: sh
|
||||||
|
|
||||||
|
pkg install nano
|
||||||
|
|
||||||
|
|
||||||
|
.. Note::
|
||||||
|
|
||||||
|
OPNsense® is a firewall distribution, we aim to keep our footprint as small as possible. This means that we don't build
|
||||||
|
all the software available in the world. If you need a specific package for your use-case, you could always ask via
|
||||||
|
a support ticket on `GitHub <https://github.com/opnsense/tools/issues>`__, but note that packages not used by our core system or
|
||||||
|
a supported plugin would not be guaranteed in the future (build contents may change over time).
|
||||||
|
|
||||||
|
|
||||||
|
.. Warning::
|
||||||
|
|
||||||
|
Adding (FreeBSD, HardenedBSD, ..) repositories in :code:`/usr/local/etc/pkg/repos/` manually is not supported and usually lead to unexpected
|
||||||
|
issues. Before reporting any type of issue with such setups, we kindly ask you to revert to a standard setup first.
|
||||||
|
|
||||||
|
The ports tree
|
||||||
|
....................................
|
||||||
|
|
||||||
|
In case your using software, which is not supplied by us, you can always build these packages yourself.
|
||||||
|
The easiest way is to look at our `tools <https://github.com/opnsense/tools>`__ repository to checkout our build requirements.
|
||||||
|
|
||||||
|
.. Note::
|
||||||
|
|
||||||
|
There are a lot of resources available about building ports packages, such as `https://www.freebsd.org/ports/ <https://www.freebsd.org/ports/>`__ and
|
||||||
|
the pointers in our documentation and tools.
|
||||||
|
We consider building custom software a feature not usable for beginners, before creating support tickets, make sure you have
|
||||||
|
the necessary skillsets needed to perform such tasks.
|
Loading…
Reference in New Issue