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

(If you don’t have discourse binary, you can use the rake version: bundle exec rake posts:remap["talk.foo.com", "talk.bar.com"])

answer its paranoia prompt, and finally

rake posts:rebake

This remaps text in posts from the old URL to the new URL, then regenerates all posts just in case.

There is really no reason for a rebake?
The remap already took care of mapping the old URL to the new URL.

[philh]

@SaraDev Thanks for keeping things tidy. Can you have a look at:

@Discourse

run ./discourse-setup to input the new domain information

and

@Discourse

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.

Maybe I am missing something but… If you use the ./discourse-setup method you will need to set the ip for the new domain prior to running ./discourse-setup to prevent the dreaded domain check failure, yikes.

Using the talk.foo.com → talk.bar.com convention

Hostname for your Discourse? [talk.foo.com]: talk.bar.com

Checking your domain name . . .
WARNING: Port 443 of computer does not appear to be accessible using hostname: talk.bar.com.
WARNING: Connection to http://talk.bar.com (port 80) also fails.

[SaraDev (Sara Devlaeminck)]

Hi @philh,

Thanks for mentioning this:

@philh

If you use the ./discourse-setup method you will need to set the ip for the new domain prior to running ./discourse-setup to prevent the dreaded domain check failure

This is correct, and if you run ./discourse-setup to and input the new domain information instead of editing app.yml you will need to setup the DNS records for your new domain first.

This information has updated this in the guide to reflect the correct order for updating the domain in this situation.

[philh]

Thanks Sara!

BTW: I am pretty sure there is a domain check during rebuild running ./launcher rebuild app which would suggest dns should be updated 1st either way: direct edit of app.yml or ./discourse-setup

Thanks again for working to keep things tidy. Up to date instructions does help the newer folks that come along.

[alltiagocom (Tiago)]

이걸 해보고 싶은데, 저는 Digital Ocean을 사용 중이고 전문가가 아닙니다. 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. forum에 대한 기존 A 또는 CNAME 기록을 찾습니다.
5. 편집합니다:
   • 이름: forum
   • 내용: 1.1.1.1 (또는 서버 IP)
6. 저장을 클릭합니다.

---

GoDaddy

1. GoDaddy 계정에 로그인합니다.
2. 도메인을 클릭한 다음 도메인을 선택합니다.
3. 추가 설정 아래에서 DNS 관리를 클릭합니다.
4. 기록 섹션으로 스크롤합니다.
5. forum에 대한 A 기록 또는 CNAME을(를) 찾아 편집 아이콘을 클릭합니다.
6. 다음을 업데이트합니다:
   • 호스트: forum
   • 가리키는 대상: 1.1.1.1
7. 저장을 클릭합니다.

---

Namecheap

1. Namecheap 계정에 로그인합니다.
2. 도메인 목록으로 이동한 다음 도메인 옆의 관리를 클릭합니다.
3. 고급 DNS 탭을 엽니다.
4. 호스트 기록에서 forum이 포함된 항목을 찾습니다.
5. 편집을 클릭하고 다음을 업데이트합니다:
   • 호스트: forum
   • 값: 1.1.1.1
6. 변경 사항을 저장하려면 녹색 체크표시를 클릭합니다.

---

DNS 변경 사항은 제공업체와 TTL 설정에 따라 완전히 전파되는 데 몇 분에서 최대 48시간까지 걸릴 수 있습니다.

참고: DNS 변경 단계는 AI를 사용하여 생성되었으며, 제공업체에 따라 달라지거나 오류가 있을 수 있습니다.

[alltiagocom (Tiago)]

제 문제는 실제로 DNS가 아니라 Digital Ocean와 관련된 것이었습니다. DNS는 Cloudflare에서 쉽게 변경할 수 있었죠. 결국 Digital Ocean에서 변경할 필요가 없음을 깨달았습니다.

어쨌든 답변해 주셔서 감사합니다!