I have Discourse set up but it’s not at the domain/subdomain it will go live at. I’m still thinking about the choice of subdomain. Now that I’m starting to configure things, I’m wondering how much changing the domain/subdomain is likely to break things. Should I hurry up and get Discourse in its forever home before I create too much content and configure settings, or does it not matter because the change of domain is trivial?

Right… hmm I’ll probably get cracking on moving it to its final domain then :sweat_smile:

There is also a guide about this [image] Change the domain name or rename your Discourse Self-Hosting bookmark 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. warning 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 …

[image] stephtara: how much changing the domain/subdomain is likely to break things A list of considerations for changing site hostname is probably a good idea! Off the top of my head: things fixable with a host redirect: inbound links one-time login links links in emails search engine indexes things that will or probably will need reconfiguration: federated logins SSO TLS cert container definition things that will unconditionally break: U2F tokens Passkeys existing login sessions

How much does changing the subdomain/domain break things?

Product Support

pfaffman (Jay Pfaffman) December 14, 2025, 10:53am 2

You need to make a backup on the old/current domain and restore after you’ve changed to the new one.

Topic		Replies	Views
Changing discourse from domain to subdomain? Product Support	5	1664	December 19, 2022
Changing the subdomain Self-hosting	1	3217	July 8, 2015
Migrate discourse from main domain --> subdomain Self-hosting	4	433	June 18, 2024
Change the domain name or rename your Discourse Self-Hosting how-to , domains	7	204986	June 19, 2025
How to change the domain for Discourse? Product Support	1	1323	January 31, 2019

How much does changing the subdomain/domain break things?

Related topics