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-setupagain and input the new domain information instead of editingapp.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, Yahoo, 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=
Alternatively, use Rake if discourse binary is unavailable, you can use the rake version:
bundle exec rake posts:remap["=BEFORE=", "=AFTER="]
Finalize with:
rake posts:rebake
This ensures that the domain name remaps in existing posts, and content is regenerated as necessary.
wondering how we created that form?
Last edited by @SaraDev 2024-12-13T00:50:25Z
Check document
Perform check on document:
这表明无论如何都应该先更新 DNS：直接编辑 app.yml 或运行 
您是更改子域名还是完整域名？
DNS 配置示例
Cloudflare
GoDaddy
Namecheap
注意：更改 DNS 的步骤是使用 AI 生成的，它们可能有所不同或包含错误。