upstream/opnsense-docs
1
0
Fork 0
mirror of https://github.com/opnsense/docs.git synced 2026-04-20 22:01:37 -04:00
Code Issues Projects Releases Packages Wiki Activity Actions

development/configd - add documentation for new config imports introduced in a1b0dd8071 , closes https://github.com/opnsense/docs/issues/532

Browse source
This commit is contained in:
Ad Schellevis 2024-01-23 16:42:44 +01:00
parent ca43be6a7c
commit c5bed41355
2 changed files with 39 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

32
source/development/backend/configd.rst
View file

@ -100,3 +100,35 @@ Next use the supplied helper command to execute our action:
::
configctl sshd restart
-----------------------------
Extending the Environment
-----------------------------
Configd's own configuration can be found in the `configd.conf <https://github.com/opnsense/core/blob/master/src/opnsense/service/conf/configd.conf>`__ file.
In some cases it can be practical to extend the envrionment with additional settings for the configd actions to use.
To add environment variables, create a new config file in the :code:`conf/configd.conf.d/` directory
using the :code:`.conf` extension containing an :code:`[environment]` section.
For example, to add a proxy server (for the firmware updater), use settings like these:
.. code-block::
:caption: /usr/local/opnsense/service/conf/configd.conf.d/proxy.conf
[environment]
HTTP_PROXY=http://proxy-adddress:8080
HTTPS_PROXY=http://proxy-adddress:8080
.. Note::
After changing the configd configuration, don't forget to restart the configd service via the gui or `service configd restart` (as root).
.. Warning::
When using the same settings as already specified in the base configuration, these settings will be overwritten. The parsing order
of configuration files is to read all vendor shipped properties first and read additional files next. Last property found is the one
being used (e.g. specifying a new :code:`PATH` in the environment, will overwrite the one being shipped in our :code:`configd.conf`.)

7
source/manual/firmware.rst
View file

@ -66,6 +66,13 @@ Usually the default options are good enough here, but if you want to choose a mi
are planned for release. Just change the release type to **Development**.
.. Note::
Although OPNsense does not support the configuration of a proxy server, for services like the firmware updater it is possible
to add these settings manually in our :code:`configd` service.
For more information we refer to :doc:`the envronment section in our development docs </development/backend/configd>`.
Activate the Business Edition
...........................................