Skip to content

Latest commit

 

History

History
124 lines (77 loc) · 2.81 KB

configuration-reference.md

File metadata and controls

124 lines (77 loc) · 2.81 KB
sidebar_label sidebar_position
Configuration reference
99

Dirigent configuration reference

Dirigent uses the Symfony framework under the hood. Refer to the Symfony documentation to learn how the configuration system works.

When using the standalone image, any JSON or YAML file located directly in the /srv/config directory will be loaded as a Symfony configuration file.

Example configuration

# dirigent.yaml
dirigent:
  title: 'My Dirigent'
  slug: null
  security:
    public: false
    registration: false
  # not supported by the standalone image
  #storage:
  #  path: '%kernel.project_dir%/storage'
  packages:
    dynamic_updates: true
    dynamic_update_delay: 'PT4H'
    periodic_updates: true
    periodic_update_interval: 'P1W'
  dist_mirroring:
    enabled: false
    preferred: true
    dev_packages: false

dirigent (root)

title

Type: string | Default: 'My Dirigent'

The application name as shown in views and emails.

slug

Type: string | Default: null

A simplified (lowercase and alphanumeric) version of the application name used as identifier for the registry. Defaults to a simplified version of the application title.

security

public

Type: boolean | Default: false

Enable public access to the registry. If disabled, only registered users will be able to view and download packages.

Note that enabling public access can lead to abuse of your resources

registration

Type: boolean | Default: false

Enable public registration. If disabled, new users can only be created by

storage

path

Type string | Default: '%kernel.project_dir%/storage'

The path where the application stores Composer and package data.

When using the official Docker image, this is automatically set to /srv/data and changing the storage path is not possible.

packages

dynamic_updates

Type: boolean | Default: true

Whether to enable or disable dynamic updates.

dynamic_update_delay

Type: string | Default: PT4H

The time between dynamic updates being triggered, defaults to 4 hours.

The time must be defined in the ISO 8601 durations format.

periodic_updates

Type: boolean | Default: true

Whether to enable or disable periodic updates.

periodic_update_interval

Type: string | Default: P1W

The time between periodic updates being scheduled, defaults to once a week.

The time must be defined in the ISO 8601 durations format.

dist_mirroring

enabled

Type: boolean | Default: false

Whether to enable or disable distribution mirroring

preferred

dev_packages