dan
/
liminix
1
0
Fork 5
Code Issues 3 Pull Requests 1 Projects Releases Wiki Activity

explain (badly) the module/service dynamic

This commit is contained in:
Daniel Barlow 2023-08-09 22:27:18 +01:00
parent f7b507587d
commit 3669a4000f
1 changed files with 32 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

39
doc/user.rst
View File

@ -83,19 +83,42 @@ Creating configuration.nix
========================== ==========================
You need to create a :file:`configuration.nix` that describes your device You need to create a :file:`configuration.nix` that describes your
and the services that you want to run on it. Start by copying device and the services that you want to run on it. The best way to
:file:`vanilla-configuration.nix` and adjusting it, or look in the `examples` get started is by reading one of the examples such as
directory for some pre-written configurations. :file:`examples/rotuer.nix` and modifying it to your needs.
:file:`configuration.nix` conventionally describes the packages, services, :file:`configuration.nix` conventionally describes the packages, services,
user accounts etc of the device. It does not describe the hardware user accounts etc of the device. It does not describe the hardware
itself, which is specified separately in the build command (as you itself, which is specified separately in the build command (as you
will see below). will see below).
Your configuration may include modules: it probably *should* Most of the functionality of a Liminix system is driven by *services*
include the ``standard`` module unless you understand what it which are declared by *modules*: thus, to add for example an NTP service
does and what happens if you leave it out. you first add :file:`modules/ntp` to your ``imports`` list, then
you create a service by calling :code:`config.system.service.ntp.build { .... }`
with the appropriate service-dependent configuration parameters.
.. code-block:: nix
let svc = config.system.service;
in {
# ...
imports = [
./modules/ntp
# ....
];
config.services.ntp = svc.ntp.build {
pools = { "pool.ntp.org" = ["iburst"]; };
makestep = { threshold = 1.0; limit = 3; };
};
A :ref:`full list of module options <module-options>` is provided
later in this manual.
You *most likely* want to include the ``standard`` module unless you
have a quite unusual use case for a very minimal system, in which case
you will understand what it does and what happens if you leave it out.
.. code-block:: nix .. code-block:: nix
@ -319,4 +342,6 @@ Caveats
Configuration options Configuration options
********************* *********************
.. _module-options:
.. include:: modules.rst .. include:: modules.rst