3. 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 Installing TOA 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:

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.

• 3.1. Server settings
  • 3.1.1. Data root
  • 3.1.2. Data retention
  • 3.1.3. HTTP listener
  • 3.1.4. Upload size limits
  • 3.1.5. CORS
  • 3.1.6. Time zone
  • 3.1.7. Logging
• 3.2. Domains
  • 3.2.1. Identification
  • 3.2.2. Template catalogue
    • Local file
    • Remote URL
  • 3.2.3. Document attribute overrides
  • 3.2.4. Upstream storage server
  • 3.2.5. Complete example
• 3.3. Overriding configuration
  • 3.3.1. External configuration file
  • 3.3.2. Environment variables
  • 3.3.3. Command-line arguments
  • 3.3.4. Precedence