NAME

       dune-config - configuring the dune build system

SYNOPSIS

       ~/.config/dune/config

DESCRIPTION

       Unless --no-config or -p is passed, Dune will read a configuration file from the user home directory.
       This file is used to control various aspects of the behavior of Dune.

       The configuration file is normally ~/.config/dune/config on Unix systems and Local Settings/dune/config
       in the User home directory on Windows. However, it is possible to specify an alternative configuration
       file with the --config-file option.

       The first line of the file must be of the form (lang dune X.Y) where X.Y is the version of the dune
       language used in the file.

       The rest of the file must be written in S-expression syntax and be composed of a list of stanzas. The
       following sections describe the stanzas available.

CACHING

       Syntax: (cache ENABLED)

        This stanza determines whether dune's build caching is enabled. See
       https://dune.readthedocs.io/en/stable/caching.html for details. Valid values for  ENABLED are  enabled or
       disabled.

DISPLAY MODES

       Syntax: (display MODE)

       This stanza controls how Dune reports what it is doing to the user. This parameter can also be set from
       the command line via --display MODE. The following display modes are available:

       progress
           This is the default, Dune shows and update a status line as build goals are being completed.

       quiet
           Only display errors.

       short
           Print  one  line  per  command  being executed, with the binary name on the left and the reason it is
           being executed for on the right.

       verbose
           Print the full command  lines  of  programs  being  executed  by  Dune,  with  some  colors  to  help
           differentiate programs.

       Note that when the selected display mode is progress and the output is not a terminal then the quiet mode
       is  selected  instead. This rule doesn't apply when running Dune inside Emacs. Dune detects whether it is
       executed from inside Emacs or not by looking at the environment variable  INSIDE_EMACS  that  is  set  by
       Emacs.  If  you  want  the  same  behavior with another editor, you can set this variable. If your editor
       already sets another variable, please open a ticket on the ocaml/dune GitHub project so that we  can  add
       support for it.

JOBS

       Syntax: (jobs NUMBER)

       Set the maximum number of jobs Dune might run in parallel. This can also be set from the command line via
       -j NUMBER.

       The default for this value is the number of processors.

SANDBOXING

       Syntax: (sandboxing_preference MODE ...)

       Controls  the  sandboxing  mode  preference order used by dune. Dune will use the earliest item from this
       list that's allowed by the action dependency specification, or fall back on the hard-coded  default.  See
       man dune-build for the description of individual modes.

BUGS

       Check bug reports at https://github.com/ocaml/dune/issues

Dune                                                                                              dune-config(5)