..
  This file is part of PEPSI.
  Copyright (C) 2026 Pepsi contributors

  PEPSI is free software; you can redistribute it and/or modify it under the
  terms of the GNU Affero General Public License as published by the Free
  Software Foundation; either version 3, or (at your option) any later version.

============
pepsi-config
============

*Inspect the effective configuration shared by every component.*

Role
====

``pepsi-config`` looks up, expands and dumps the merged Pepsi configuration.
Every component reads the same INI-style configuration file, so a single tool
serves them all; the per-component ``config`` subcommands earlier releases
shipped have been retired in favour of this one. It only reads the
configuration — no database connection, no network access. Reference:
:manpage:`pepsi-config(1)`.

Features
========

* **get** — print the value of an option in a section; with ``--filename`` the
  value is treated as a path and ``$``-expanded.
* **pathsub** — substitute ``${VAR}``/``$VAR`` placeholders in a path expression
  from the ``[PATHS]`` section and the environment.
* **dump** — print the merged configuration; with ``--diagnostics`` it also
  records the file and line each option came from.

Validation
==========

``pepsi-config dump`` pairs with :manpage:`pepsi-setup(1)`'s ``check`` when
validating an installation: ``check`` queries live DNS, while ``dump`` shows the
effective values the components will actually see.

See also
========

:doc:`pepsi-setup`, :doc:`../configuration`, :manpage:`pepsi-config(1)`,
:manpage:`pepsi.conf(5)`.