Skip to content

Additional Project Hostnames

You can add hostnames to a project by editing its config file or using the ddev config command.

Use the additional_hostnames array in .ddev/config.yaml:

name: mysite

  - "extraname"
  - "fr.mysite"
  - "es.mysite"
  - "it.mysite"
  - "*.lotsofnames"

This configuration would result in working hostnames of,,,, and, with full HTTP and HTTPS URLs for each.

You could accomplish the same thing by running the ddev config command:

ddev config --additional-hostnames extraname,fr.mysite,es.mysite,it.mysite,*.lotsofnames

In addition, the wildcard *.lotsofnames will result in anything * being recognized by the project. This works only if you’re connected to the internet, using for your top-level-domain, and using DNS for name lookups. (These are all the defaults.)

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

Don’t use the same additional_fqdns or additional_hostnames in two different projects.

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.

May not work predictably everywhere.

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.

Don’t override a real domain name!

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.