Skip to content
Branch: master
Find file Copy path
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
37 lines (24 sloc) 1.78 KB

Additional Project Hostnames

Add additional hostnames to a project in the project's .ddev/config.yaml:

name: mysite

- extraname
- fr.mysite
- es.mysite
- it.mysite

This configuration would result in working hostnames of,,,, and (with full http and https URLs for each).

Although we recommend extreme care with this feature, you can also provide additional_fqdn entries, which don't use the "" top-level domain. This feature populates your hosts file with entries which may hide the real DNS entries on the internet, causing way too much head-scratching.

**If you use a FQDN which is resolvable on the internet, you must use use_dns_when_possible: false or configure that with ddev config --use-dns-when-possible=false.

name: somename


This configuration would result in working FQDNs of,,, and

Note: If you see ddev-router status become unhealthy in ddev list, it's most often a result of trying to use conflicting FQDNs in more than one project. "" can only be assigned to one project, or it will break ddev-router.

Warning: this may not work predictably on all systems. There are operating systems and machines where /etc/hosts may not be the first or only resolution technique, especially if the additional_fqdn you use is also in DNS.

Warning: if you use an additional_fqdn that exists on the internet (like ""), your hosts file will override access to the original (internet) site, and you'll be sad and confused that you can't get to it.

You can’t perform that action at this time.