Configure your hosted Discourse site to run at the root or apex domain (e.g. example.com)

Most hosted discourse instances are on a subdomain:

forum.example.com
talk.example.com
www.example.com

This is our general recommendation in almost all cases, and it works great. However, if you wish to use a root domain or apex domain for your hosted discourse, like so

example.com

this turns out to be surprisingly difficult in a hosting scenario, due to the vagaries of how DNS works. :thinking:

It is possible, however, you must use a DNS provider that specifically supports it!

DNS provider documentation

Here is a list of known-compatible DNS providers, the name of the DNS type that you should use, and a link to their docs.

Provider Type
AWS Route53 (AWS only[1]) A & AAAA ALIAS records; click for example →
CloudFlare CNAME flattening · Cloudflare DNS docs
DNSimple ALIAS
DNS Made Easy ANAME
DreamHost ALIAS
easyDNS ANAME
Gandi ALIAS
Hurricane Electric ALIAS
Name ANAME
Namecheap ALIAS
Webcentral (formerly Netregistry) Cloaked Redirection (IPv4 only)
PointDNS ALIAS

If your DNS provider is not one of the above, you must switch to one of these DNS providers to achieve an apex domain or root domain hosted discourse.

:exclamation: If you try/test out another DNS provider and it works for you, do reply here with the name of the DNS provider, and a link that explains how they set it up, so we can update our list. There are a lot of DNS providers, so we update the list as we find, this list is by no way a one-stop-list of every DNS provider in the world that supports this.


  1. this only works if you are self-hosted in AWS or on our AWS Enterprise Hosting ↩︎

Last edited by @dax 2026-03-13T11:58:09Z

Last checked by @MarkDoerr 2026-02-11T01:10:30Z

Check documentPerform check on document:
36 лайков

Пост был разделен на новую тему: Необходимые настройки DNS

Итак, потребовалось немного времени, чтобы разобраться, но мне удалось настроить работу моего корневого домена (apex domain) с Azure, где мы размещаем наши DNS.

Для использования Azure необходимо задействовать Azure Front Door. Данные инструкции относятся к Azure Front Door Standard/Premium, а не к Azure Front Door (классическая версия).

  1. Перейдите в раздел Azure Front Door и нажмите + Создать.
  2. Выберите Azure Front Door и Создание настраиваемого, затем нажмите Продолжить создание Front Door.
  3. Выберите подписку, группу ресурсов, имя и уровень (Standard мне подошел), затем нажмите Далее: Секреты.
  4. Если вы используете собственный SSL-сертификат, добавьте его здесь. После добавления (или если вы позволяете Azure создать сертификат) нажмите Далее: Конечная точка.
  5. Нажмите Добавить конечную точку, выберите имя и нажмите Добавить.
  6. В новом разделе «Маршруты» нажмите Добавить маршрут. Присвойте ему имя.
  7. В поле «Группа источников» нажмите Добавить новую группу источников. Присвойте ей имя.
  8. Нажмите + Добавить источник. Присвойте ему имя. В поле «Тип источника» выберите Настраиваемый. В поле «Имя хоста» введите ваш домен site.hosted-by-discourse.com. Убедитесь, что поле «Заголовок хоста источника» пустое. Нажмите Добавить.
  9. Нажмите Добавить в диалоговом окне «Добавить группу источников».
  10. Нажмите Добавить в диалоговом окне «Добавить маршрут».
  11. Нажмите Проверка и создание. Нажмите Создать.
  12. Дождитесь развертывания AFD. После развертывания нажмите Перейти к ресурсу.
  13. В левом меню выберите Домены. Нажмите Добавить домен.
  14. В поле «Зона DNS» выберите зону, в которой находится ваш домен. В разделе «Настраиваемый домен» выберите ваш домен в секции КОРНЕВОЙ (APEX). Нажмите Добавить.
  15. Когда ваш домен появится в списке, нажмите справа. Выберите Связать.
  16. Выберите созданную ранее конечную точку и маршрут. Нажмите Связать.

Если вы используете управляемый сертификат AFD

  1. Если «Состояние проверки» вашего домена — В ожидании, нажмите эту ссылку. Выберите Минуты в качестве «Единицы TTL» (для быстрой проверки), затем нажмите кнопку Добавить в разделе «Статус DNS-записи».
  2. БУДЬТЕ ТЕРПЕЛИВЫ. Именно здесь я потратил слишком много времени, рвя на себе волосы, но вам нужно подождать. В конце концов «Состояние проверки» должно измениться на Утверждено.
  3. Возможно, вам придется сгенерировать заново и обновить TXT DNS-запись. Это можно сделать, нажав кнопку Сгенерировать заново. Когда появится кнопка Обновить в разделе «Статус DNS-записи», нажмите её.
1 лайк

К сведению для всех, кто следует этому руководству: данная настройка не упрощает DNS, а конфигурирует балансировщик нагрузки в Azure для проксирования источника.

Это официально не поддерживается в таком виде, так как это приведет к побочным эффектам (все посетители будут приходить с IP-адреса Azure, а не с их реальных IP-адресов).

2 лайка