# How do I configure a subdomain for Discourse?
**URL:** https://meta.discourse.org/t/how-do-i-configure-a-subdomain-for-discourse/366299
**Category:** Support
**Created:** [May 15, 2025, 4:17pm UTC](https://meta.discourse.org/t/how-do-i-configure-a-subdomain-for-discourse/366299 "2025-05-15T16:17:29Z")
**Posts on this page:** 13
**Page:** 1
### Author:  [@Matthias\_Schuster](https://meta.discourse.org/u/Matthias_Schuster)
#### Post date: [May 15, 2025, 4:17pm UTC](https://meta.discourse.org/t/how-do-i-configure-a-subdomain-for-discourse/366299/1 "2025-05-15T16:17:29Z")
Hi there 🙂
I am following this guide on [Github](https://github.com/discourse/discourse/blob/main/docs/INSTALL-cloud.md#1-preparing-your-domain-name) and you are recommending Namecheap there.
I did follow up on this, and you say, I have to check a subdomain.
Two problems:
Absolutely nowhere on Namecheap is any option to be found, that lets me do that.
Absolutely nowhere on your documentation is mentioned, how I could do that.
---
### Author:  [@pfaffman](https://meta.discourse.org/u/pfaffman)
#### Post date: [May 15, 2025, 5:17pm UTC](https://meta.discourse.org/t/how-do-i-configure-a-subdomain-for-discourse/366299/3 "2025-05-15T17:17:50Z")
You’ll just create an A record for whatever subdomain you want as described at [https://www.namecheap.com/support/knowledgebase/article.aspx/319/2237/how-can-i-set-up-an-a-address-record-for-my-domain/](https://www.namecheap.com/support/knowledgebase/article.aspx/319/2237/how-can-i-set-up-an-a-address-record-for-my-domain/).
---
### Author:  [@Matthias\_Schuster](https://meta.discourse.org/u/Matthias_Schuster)
#### Post date: [May 15, 2025, 5:19pm UTC](https://meta.discourse.org/t/how-do-i-configure-a-subdomain-for-discourse/366299/4 "2025-05-15T17:19:16Z")
Thanks a lot!
---
### Author:  [@Matthias\_Schuster](https://meta.discourse.org/u/Matthias_Schuster)
#### Post date: [May 16, 2025, 2:40am UTC](https://meta.discourse.org/t/how-do-i-configure-a-subdomain-for-discourse/366299/5 "2025-05-16T02:40:53Z")
Personally, that isn’t really helping, since there are no clear, dedicated instructions on how to setup a subdomain.
Also, the guide still does not say anything at all about that.
Are we sure, that’s helping people as is?
---
### Author:  [@Heliosurge](https://meta.discourse.org/u/Heliosurge)
#### Post date: [May 16, 2025, 2:57am UTC](https://meta.discourse.org/t/how-do-i-configure-a-subdomain-for-discourse/366299/6 "2025-05-16T02:57:23Z")
It is in the [Standard install](https://meta.discourse.org/t/142537?silent=true) instructions on GitHub.
“Your DNS controls should be accessible from the place where you purchased your domain name. This is where you will create a DNS [A record](https://support.dnsimple.com/articles/a-record/) for the [discourse.example.com](http://discourse.example.com) hostname once you know the IP address of the cloud server where you are installing Discourse, as well as enter your SPF and DKIM records for your email.”
>
---
### Author:  [@pfaffman](https://meta.discourse.org/u/pfaffman)
#### Post date: [May 16, 2025, 3:49pm UTC](https://meta.discourse.org/t/how-do-i-configure-a-subdomain-for-discourse/366299/8 "2025-05-16T15:49:55Z")
> [@Matthias\_Schuster](#):
>
> Personally, that isn’t really helping, since there are no clear, dedicated instructions on how to setup a subdomain.
That’s because there is nothing to it. It’s just a DNS A record that points to a server.
On some systems “setting up a subdomain” seems like a big deal since those systems do a bunch of stuff, including installing something that will answer https requests (you’ll install Discourse) that runs somewhere (you’ll create a VM) and point a DNS record to it (the part that you seem to be having a hard time understanding?).
---
### Author:  [@merefield](https://meta.discourse.org/u/merefield)
#### Post date: [May 16, 2025, 3:54pm UTC](https://meta.discourse.org/t/how-do-i-configure-a-subdomain-for-discourse/366299/9 "2025-05-16T15:54:02Z")
I was wrong about @, apologies, the column is “Host”.
Here’s a few examples:
Where Value is the desired IP address.
so:
- `demo.example.com`
- `dev.example.com`
- `snow.example.com`
That’s literally it!
(though you will also need to request a certificate using something like Let’s Encrypt from the server unless it’s automatically done like it is with Discourse)
---
### Author:  [@Matthias\_Schuster](https://meta.discourse.org/u/Matthias_Schuster)
#### Post date: [May 19, 2025, 9:02pm UTC](https://meta.discourse.org/t/how-do-i-configure-a-subdomain-for-discourse/366299/10 "2025-05-19T21:02:29Z")
For somebody who has never dealt with that, thats not nothing.
---
### Author:  [@Matthias\_Schuster](https://meta.discourse.org/u/Matthias_Schuster)
#### Post date: [May 19, 2025, 9:04pm UTC](https://meta.discourse.org/t/how-do-i-configure-a-subdomain-for-discourse/366299/11 "2025-05-19T21:04:49Z")
That comes already closer to an actual solution. The people would still not know, how to gain their IP address.
If this is supposed to be limited to people who are already web developers, than the current docs are probably fitting.
If you intend to provide the opportunities that come with Discourse for everyone equally, there is some way to go.
My web dev has had a lot of struggles with the setup of the SMTP host, as an example - I would have never been able to perform that.
---
### Author:  [@merefield](https://meta.discourse.org/u/merefield)
#### Post date: [May 19, 2025, 9:07pm UTC](https://meta.discourse.org/t/how-do-i-configure-a-subdomain-for-discourse/366299/12 "2025-05-19T21:07:44Z")
> [@Matthias\_Schuster](#):
>
> The people would still not know, how to gain their IP address.
It’s the same IP address as the VPS you log into to install Discourse.
---
### Author:  [@Matthias\_Schuster](https://meta.discourse.org/u/Matthias_Schuster)
#### Post date: [May 19, 2025, 9:30pm UTC](https://meta.discourse.org/t/how-do-i-configure-a-subdomain-for-discourse/366299/13 "2025-05-19T21:30:36Z")
That is all information, that is relevant to be documented for a new user. I am willing to put in this work, in case you are interested to merge it.
---
### Author:  [@Heliosurge](https://meta.discourse.org/u/Heliosurge)
#### Post date: [May 23, 2025, 11:23pm UTC](https://meta.discourse.org/t/how-do-i-configure-a-subdomain-for-discourse/366299/14 "2025-05-23T23:23:50Z")
> [@Matthias\_Schuster](#):
>
> That comes already closer to an actual solution. The people would still not know, how to gain their IP address.
Maybe a bit more detail. However your VPs provider has the IP address in the Dashboard with server specs.
> [@Matthias\_Schuster](#):
>
> My web dev has had a lot of struggles with the setup of the SMTP host, as an example - I would have never been able to perform that
How easy this is will depend on the SMTP you choose to use. For example [Brevo.com](http://Brevo.com) it is just sign up a username and password and either use the free or paid plans.
> Then just entering the username, password in discourse setup and the SMTP address
The above is standard in discourse. The smpt provider may also have instructions to create a DNS record if I have it correct to have the dkim to help ensure mail delivery.
Then you have some like Lark which is more complicated setup then what I posted above.
This is why Discourse Meta is here to help provide official and community based support. If one has a budget there are many folks that will do the initial setup and some like @pfaffman for self hosted folks has a support dashboard for a small yearly fee that also includes his support. The Dashboard gives options to make installing plugins and doing some command line upkeep for less techy savvy users.
Just to be clear I do sympathize with where your coming from and have to say. In this day and age a gui UX is considered more standardized for every day layman users.
---
### Author:  [@system](https://meta.discourse.org/u/system)
#### Post date: [June 22, 2025, 11:24pm UTC](https://meta.discourse.org/t/how-do-i-configure-a-subdomain-for-discourse/366299/15 "2025-06-22T23:24:47Z")
This topic was automatically closed 30 days after the last reply. New replies are no longer allowed.