.. _configure:

==============
Configuration
==============

This chapter is a reference for the TOA server configuration file.
In a standard deployment the file lives at
``/opt/toa-server/config/toa-server.yml`` and is loaded at startup
through the ``--spring.config.additional-location`` argument on the
``java -jar`` command line (see :ref:`install-server`).

The file is parsed by Spring Boot and uses plain YAML. All TOA-specific
keys live under the top-level ``toa-server:`` block. Other Spring Boot
properties (``server.*``, ``logging.*``, ``spring.*``) may be added at
the same top level to override defaults baked into the server jar -
for example, to change the HTTP port or raise the upload size limits.

A complete minimal file covers one domain:

.. code-block:: yaml

   toa-server:
     dataRoot: /var/lib/toa-server/data
     domains:
       - code: production
         name: Production domain
         templates:
           url: https://cmserver.customer.cz/cmserver2.xml
         storageServer:
           url: https://damis.customer.cz/damis/upload
           domain: b2

Everything else has sensible defaults. The sections below document each
knob in detail.

.. toctree::

   server.rst
   domains.rst
   overrides.rst