Type object
File match **/.ddev/global_config.yaml
Schema URL https://catalog.lintel.tools/schemas/schemastore/ddev-global/latest.json
Source https://raw.githubusercontent.com/ddev/ddev/master/pkg/globalconfig/schema.json

Validate with Lintel

npx @lintel/lintel check
Type: object

Schema for DDEV global_config.yaml

Properties

developer_mode boolean

Not currently used.

fail_on_hook_fail boolean

Whether "ddev start" should be interrupted by a failing hook, on a single project or for all projects if used globally.

instrumentation_opt_in boolean

Whether to allow instrumentation reporting.

instrumentation_queue_size integer

Maximum number of locally collected events for instrumentation reporting.

instrumentation_reporting_interval integer

Reporting interval in hours for instrumentation reporting.

instrumentation_user string

Specific name identifier for instrumentation reporting.

internet_detection_timeout_ms integer

Internet detection timeout in milliseconds.

last_started_version string

Last started version using "ddev --version" command.

letsencrypt_email string

Email associated with Let's Encrypt feature. (Works in conjunction with use_letsencrypt.)

mailpit_http_port string

Router port used for Mailpit HTTP, can be overridden in project config.

Any of: string string, string string
mailpit_https_port string

Router port used for Mailpit HTTPS, can be overridden in project config.

Any of: string string, string string
messages object

Configure messages like the Tip of the Day.

1 nested properties
ticker_interval integer required
mkcert_caroot string

The absolute path to the directory containing mkcert certificates using "mkcert -CAROOT" command.

no_bind_mounts boolean

Whether to not use Docker bind mounts.

no_tui boolean

Whether to disable the TUI (terminal user interface) when running the "ddev" command without arguments.

omit_containers string[]

List of container types that should not be started when the project is started.

uniqueItems=true
omit_project_name_by_default boolean

Whether to omit the project name from config.yaml and use directory name instead.

performance_mode string

Define the performance optimization mode to be used. Currently, Mutagen asynchronous caching is supported. Mutagen is enabled by default on Mac and Windows.

Values: "none" "mutagen"
project_tld string

Set the top-level domain to be used for projects, defaults to "ddev.site".

Any of: string string, string string
required_docker_compose_version string

Specific docker-compose version for download.

router_bind_all_interfaces boolean

Whether to bind ddev-router's ports on all network interfaces.

router_http_port string

Router HTTP port for all projects, can be overridden in project config.

Any of: string string, string string
router_https_port string

Router HTTPS port for all projects, can be overridden in project config.

Any of: string string, string string
share_default_provider string

Default share provider for all projects, can be overridden in project config.

Any of: string string, string string
simple_formatting boolean

Whether to disable most "ddev list" and "ddev describe" table formatting.

table_style string

Style for "ddev list" and "ddev describe".

Values: "default" "bold" "bright"
traefik_monitor_port string

Specify an alternate port for the Traefik (ddev-router) monitor port. This defaults to 10999 and rarely needs to be changed, but can be changed in cases of port conflicts.

Any of: string string, string string
use_docker_compose_from_path boolean

Whether to use the system-installed docker-compose. You can otherwise use required_docker_compose_version to specify a version for download.

use_hardened_images boolean

Whether to use hardened images for internet deployment.

use_letsencrypt boolean

Whether to enable Let's Encrypt integration. (Works in conjunction with letsencrypt_email.)

web_environment string[]

Add environment variables to the web container.

uniqueItems=true
wsl2_no_windows_hosts_mgt boolean

(WSL2 only) Whether to disable the management and checking of the Windows hosts file. By default, when using WSL2, DDEV manages the system-wide hosts file on the Windows side (normally C:\Windows\system32\drivers\etc\hosts) by using ddev.exe installed on the Windows side. This normally works better for all applications, including browsers and IDEs. However, this behavior can be disabled by setting "wsl_no_windows_hosts_mgt: true".

xdebug_ide_location string

Adjust Xdebug listen location for WSL2 or in-container.

xhgui_http_port string

Router port used for XHGui HTTP, can be overridden in project config.

Any of: string string, string string
xhgui_https_port string

Router port used for XHGui HTTPS, can be overridden in project config.

Any of: string string, string string
xhprof_mode string

Define the default XHProf usage mode.

Values: "prepend" "xhgui"
remote_config object

Configuration for remote config and sponsorship data sources.

4 nested properties
update_interval integer

Update interval in hours for remote config and sponsorship data.

min=1
remote_config_url string

URL for downloading remote configuration data.

format=uri
sponsorship_data_url string

URL for downloading sponsorship data.

format=uri
addon_data_url string

URL for downloading add-on registry data.

format=uri