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

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

This configuration would result in working hostnames of mysite.ddev.site, extraname.ddev.site, fr.mysite.ddev.site, es.mysite.ddev.site, and it.mysite.ddev.site, 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 *.lotsofnames.ddev.site being recognized by the project. This works only if you’re connected to the internet, using ddev.site 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 .ddev.site 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

additional_fqdns:
- example.com
- somesite.example.com
- anothersite.example.com

This configuration would result in working FQDNs of somename.ddev.site, example.com, somesite.example.com, and anothersite.example.com.

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. example.com 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 www.google.com), 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.