ddev config

Create or modify a ddev project configuration in the current directory

Subcommands

NameDescription
globalChange global configuration

Options

NameDescription
--additional-fqdns <additional-fqdns>A comma-delimited list of FQDNs for the project
--additional-hostnames <additional-hostnames>A comma-delimited list of hostnames for the project
--apptype <apptype>Provide the project type (one of backdrop, drupal10, drupal6, drupal7, drupal8, drupal9, laravel, magento, magento2, php, shopware6, typo3, wordpress). This is autodetected and this flag is necessary only to override the detection. This is the same as --project-type and is included only for backwards compatibility
--autoAutomatically run config without prompting
--bind-all-interfacesBind host ports on all interfaces, not just on localhost network interface
--composer-root <composer-root>Overrides the default composer root directory for the web service
--composer-root-defaultUnsets a web service composer root directory override
--composer-version <composer-version>Specify override for composer version in web container. This may be "", "1", "2", "2.2", "stable", "preview", "snapshot" or a specific version
--create-docrootPrompts ddev to create the docroot if it doesn't exist
--database <database>Specify the database type:version to use. Defaults to mariadb:10.4
--db-image <db-image>Sets the db container image
--db-image-defaultSets the default db container image for this ddev version
--db-working-dir <db-working-dir>Overrides the default working directory for the db service
--db-working-dir-defaultUnsets a db service working directory override
--dba-image <dba-image>Sets the dba container image
--dba-image-defaultSets the default dba container image for this ddev version
--dba-working-dir <dba-working-dir>Overrides the default working directory for the dba service
--dba-working-dir-defaultUnsets a dba service working directory override
--dbimage-extra-packages <dbimage-extra-packages>A comma-delimited list of Debian packages that should be added to db container when the project is started
--default-container-timeout <default-container-timeout>Default time in seconds that ddev waits for all containers to become ready on start
--disable-settings-managementPrevent ddev from creating or updating CMS settings files
--docroot <docroot>Provide the relative docroot of the project, like 'docroot' or 'htdocs' or 'web', defaults to empty, the current directory
--fail-on-hook-failDecide whether 'ddev start' should be interrupted by a failing hook
--host-db-port <host-db-port>The db container's localhost-bound port
--host-dba-port <host-dba-port>The dba (PHPMyAdmin) container's localhost-bound port, if exposed via bind-all-interfaces
--host-https-port <host-https-port>The web container's localhost-bound https port
--host-webserver-port <host-webserver-port>The web container's localhost-bound port
--http-port <http-port>The router HTTP port for this project
--https-port <https-port>The router HTTPS port for this project
--image-defaultsSets the default web, db, and dba container images
--mailhog-https-port <mailhog-https-port>Router port to be used for mailhog access (https)
--mailhog-port <mailhog-port>Router port to be used for mailhog access
--mutagen-enabledEnable mutagen asynchronous update of project in web container
--nfs-mount-enabledEnable NFS mounting of project in container
--ngrok-args <ngrok-args>Provide extra args to ngrok in ddev share
--no-project-mountWhether or not to skip mounting project code into the web container
--nodejs-version <nodejs-version>Specify the nodejs version to use if you don't want the default NodeJS 16
--omit-containers <omit-containers>A comma-delimited list of container types that should not be started when the project is started
--php-version <php-version>The version of PHP that will be enabled in the web container
--phpmyadmin-https-port <phpmyadmin-https-port>Router port to be used for PHPMyAdmin (dba) container access (https)
--phpmyadmin-port <phpmyadmin-port>Router port to be used for PHPMyAdmin (dba) container access
--project-name <project-name>Provide the project name of project to configure (normally the same as the last part of directory name)
--project-tld <project-tld>Set the top-level domain to be used for projects, defaults to ddev.site
--project-type <project-type>Provide the project type (one of backdrop, drupal10, drupal6, drupal7, drupal8, drupal9, laravel, magento, magento2, php, shopware6, typo3, wordpress). This is autodetected and this flag is necessary only to override the detection
--projectname <projectname>Provide the project name of project to configure (normally the same as the last part of directory name)
--projecttype <projecttype>Provide the project type (one of backdrop, drupal10, drupal6, drupal7, drupal8, drupal9, laravel, magento, magento2, php, shopware6, typo3, wordpress). This is autodetected and this flag is necessary only to override the detection
--show-config-locationOutput the location of the config.yaml file if it exists, or error that it doesn't exist
--sitename <sitename>Provide the project name of project to configure (normally the same as the last part of directory name) This is the same as project-name and is included only for backwards compatibility
--timezone <timezone>Specify timezone for containers and php, like Europe/London or America/Denver or GMT or UTC
--upload-dir <upload-dir>Sets the project's upload directory, the destination directory of the import-files command
--use-dns-when-possibleUse DNS for hostname resolution instead of /etc/hosts when possible
--web-environment <web-environment>Set the environment variables in the web container: --web-environment="TYPO3_CONTEXT=Development,SOMEENV=someval"
--web-environment-add <web-environment-add>Append environment variables to the web container: --web-environment="TYPO3_CONTEXT=Development,SOMEENV=someval"
--web-image <web-image>Sets the web container image
--web-image-defaultSets the default web container image for this ddev version
--web-working-dir <web-working-dir>Overrides the default working directory for the web service
--web-working-dir-defaultUnsets a web service working directory override
--webimage-extra-packages <webimage-extra-packages>A comma-delimited list of Debian packages that should be added to web container when the project is started
--webserver-type <webserver-type>Sets the project's desired webserver type: nginx-fpm or apache-fpm
--working-dir-defaultsUnsets all service working directory overrides
--xdebug-enabledWhether or not XDebug is enabled in the web container