Change the domain name or rename your Discourse

[Discourse]

This guide explains how-to change the domain name of your Discourse site, and includes information about setting up DNS changes, editing configuration files, updating site settings, and correcting social logins and post content to reflect your new domain name.

This guide is for self-hosted Discourse instances that were installed using our installation guide on GitHub. If you are hosted by Discourse, please see Configure your domain name for hosted Discourse for specific instructions.

You may eventually want to change the domain name of your Discourse instance, from say

=BEFORE= → =AFTER=

Let’s get started.

Setting the DNS TTL low in advance

First, change the Time-To-Live (TTL) setting for your DNS to a low value like 60 minutes. This should be done days ahead of the actual domain change to ensure the change can propagate quickly across the internet.

Remove old domain name from any site settings

Visit /admin/site_settings in your Discourse admin interface, and search for any settings containing the old domain name. Update these settings to the new domain name.

Changing DNS Records

Update your DNS settings to disable the old domain and point the new domain to the IP address of your Discourse server.

Editing the site name in app.yml

You can edit the app.yml file manually to input the new domain information.

Here’s how to edit it manually:

cd /var/discourse
nano containers/app.yml

Locate the following line and replace it:

DISCOURSE_HOSTNAME: 'your.newdomain.com'

If using a Content Delivery Network (CDN), temporarily disable it by commenting out the respective line in app.yml. Rebuild your Discourse site with:

./launcher rebuild app

Alternatively, you can run ./discourse-setup again and input the new domain information instead of editing app.yml.

Check that your site is operational under the new domain.

Fixing social logins

Depending on how you logged in, you may need to do this first or you won’t be able to log in once the name is changed.

If you use social logins, update the credentials on the platforms (Twitter, Facebook, Google, GitHub) to reflect the new domain. Look for guides on the Discourse how-to category.

Remapping domain names in posts

All the existing posts will still refer to the old domain.

You’ll need to change old domain references in your posts to the new domain:

./launcher enter app

then

discourse remap =BEFORE= =AFTER=

Finalize with:

rake posts:rebake

This ensures that the domain name remaps in existing posts, and content is regenerated as necessary.

If you have a CDN, remember to reactivate it post-domain change.

wondering how we created that form?

Last edited by @SaraDev 2024-12-13T00:50:25Z

Check document

Perform check on document:

[RGJ (Richard - Communiteq)]

@Discourse

discourse remap talk.foo.com talk.bar.com

(Если у вас нет исполняемого файла discourse, вы можете использовать версию через rake: bundle exec rake posts:remap["talk.foo.com", "talk.bar.com"])

Ответьте на запрос о паранойе и, наконец,

rake posts:rebake

Это заменяет текст в сообщениях со старого URL на новый, а затем пересоздаёт все сообщения на всякий случай.

Действительно ли нет необходимости в rebake?
remap уже выполнил маппинг старого URL на новый.

[philh]

@SaraDev Спасибо за наведение порядка. Не могли бы вы взглянуть на следующее:

@Discourse

запустите ./discourse-setup, чтобы ввести информацию о новом домене

и

@Discourse

Изменение записей DNS

Обновите настройки DNS, чтобы отключить старый домен и перенаправить новый домен на IP-адрес вашего сервера Discourse.

Возможно, я что-то упускаю, но… Если вы используете метод ./discourse-setup, вам нужно будет задать IP для нового домена до запуска ./discourse-setup, чтобы избежать ужасной ошибки проверки домена, ох уж эти ошибки.

Используя соглашение talk.foo.com → talk.bar.com:

Имя хоста для вашего Discourse? [talk.foo.com]: talk.bar.com

Проверка имени домена . . .
ПРЕДУПРЕЖДЕНИЕ: Порт 443 компьютера, по-видимому, недоступен с использованием имени хоста: talk.bar.com.
ПРЕДУПРЕЖДЕНИЕ: Подключение к http://talk.bar.com (порт 80) также не удаётся.

[SaraDev (Sara Devlaeminck)]

Привет @philh,

Спасибо, что упомянули об этом:

@philh

Если вы используете метод ./discourse-setup, вам нужно будет задать IP-адрес для нового домена перед запуском ./discourse-setup, чтобы избежать фатальной ошибки проверки домена.

Это верно, и если вы запускаете ./discourse-setup и вводите информацию о новом домене вместо редактирования app.yml, вам необходимо сначала настроить DNS-записи для вашего нового домена.

Мы обновили эту информацию в руководстве, чтобы отразить правильный порядок обновления домена в такой ситуации.

[philh]

Спасибо, Сара!

Кстати: я почти уверен, что при пересборке с помощью команды ./launcher rebuild app выполняется проверка домена, что означает, что DNS следует обновить в первую очередь, независимо от способа: прямое редактирование app.yml или использование ./discourse-setup.

Ещё раз спасибо за то, что поддерживаете порядок. Актуальные инструкции очень помогают новичкам, которые приходят к нам.

[alltiagocom (Tiago)]

Я хочу сделать это, но я использую Digital Ocean и не являюсь экспертом. Нужно ли мне что-то изменить там?

Например, я вижу это:

Но, как я понимаю, это просто имя, которое я ему дал, это не реальная настройка?

Так что, если я следую инструкциям на этой странице, мне не нужно вносить никаких изменений в Digital Ocean (возможно, кроме обновления этого имени на новый домен, чтобы избежать путаницы?)

[Rhod (Rodolfo)]

@alltiagocom

Я хочу сделать это, но использую Digital Ocean и не являюсь экспертом. Что-то нужно изменить там?

Например, я вижу это:

Но, думаю, это просто имя, которое я дал, а не реальная настройка, верно?

Так что, если я буду следовать инструкциям на этой странице, мне не нужно ничего менять в Digital Ocean (возможно, кроме обновления этого имени на новый домен, чтобы избежать путаницы?)

Чтобы ваш новый сайт работал правильно, необходимо обновить настройки DNS у вашего провайдера доменных имен.

---

Пример:

Если ваш предыдущий сайт был:

forum.example.com → 1.1.1.1

Тогда вы должны изменить его на:

forum.newname.com → 1.1.1.1

---

Меняете ли вы поддомен или полный домен?

В приведенном выше примере:

• Домен: example.com
• Поддомен: forum

Убедитесь, что вы обновили свои DNS-записи соответствующим образом в зависимости от того, меняете ли вы только поддомен или полное доменное имя.

---

---

Меняете ли вы поддомен или полный домен?

В приведенном выше примере:

• Домен: example.com
• Поддомен: forum

Убедитесь, что вы обновили свои DNS-записи соответствующим образом в зависимости от того, меняете ли вы только поддомен или полное доменное имя.

---

Примеры конфигурации DNS

Cloudflare

1. Войдите в свою панель управления Cloudflare.
2. Выберите свой домен (например, example.com).
3. Перейдите на вкладку DNS.
4. Найдите существующую запись A или CNAME для forum.
5. Отредактируйте её:
   • Имя: forum
   • Содержимое: 1.1.1.1 (или IP-адрес вашего сервера)
6. Нажмите Сохранить.

---

GoDaddy

1. Войдите в свой аккаунт GoDaddy.
2. Нажмите на Домены, затем выберите свой домен.
3. В разделе Дополнительные настройки нажмите Управление DNS.
4. Прокрутите вниз до раздела Записи.
5. Найдите запись A или CNAME для forum и нажмите значок Изменить.
6. Обновите следующее:
   • Хост: forum
   • Указывает на: 1.1.1.1
7. Нажмите Сохранить.

---

Namecheap

1. Войдите в свой аккаунт Namecheap.
2. Перейдите в Список доменов > нажмите Управление рядом с вашим доменом.
3. Откройте вкладку Advanced DNS.
4. В разделе Host Records найдите запись с forum.
5. Нажмите Изменить и обновите:
   • Хост: forum
   • Значение: 1.1.1.1
6. Нажмите зеленую галочку, чтобы сохранить изменения.

---

Изменения DNS могут занять от нескольких минут до 48 часов для полной репликации в зависимости от вашего провайдера и настроек TTL.

Примечание: Шаги по изменению DNS были сгенерированы с помощью ИИ, и они могут отличаться или содержать ошибки.

[alltiagocom (Tiago)]

Моя проблема на самом деле была связана только с Digital Ocean, а не с DNS, которые я легко смог изменить в Cloudflare. Однако я выяснил, что вносить какие-либо изменения в Digital Ocean не нужно.

В любом случае, спасибо за ваш ответ!