jointakahe/content/guides/custom-domains.md

---
title: Custom Domains Guide
---

So you want to point a custom domain at takahe.social? Great! Before you start,
you need to understand a few things:

* Custom domains are limited to only our [Featured Supporter Patreon Tier](https://www.patreon.com/takahe)
  or higher, those who donate an equivalent monthly amount via direct
  invoice, or for open-source project or charities
  (email contact@jointakahe.org for information about those options).

* Once you make accounts (identities) on your custom domain, you will not be
  able to move them away from takahe.social until we implement the move
  feature in the future. Even then, your posts will not follow you, only
  your followers.

* Custom domains are not separate servers - you will still be on the same
  "server" as everyone else, see everyone else in the Local feeds, use our
  global set of server emoji, and be subject to our moderation policies and
  rules. This will change a little in future as we implement more domain
  separation and give you the option to be slightly more isolated.

If you're alright with that, then let's discuss how to set up your domain.

There's two ways you can route a domain to us:

* Pointing the whole domain at takahe.social. This is the easiest way, but
  it means you will not be able to use that domain for anything else
  (for example, if you want `@user@sub.domain.tld` to be your handle, you must
  point the entirely of `sub.domain.tld` at us and nothing else can exist on it).

* Routing users from a main domain to a Takahē-specific subdomain.
  This is generally preferred, as it lets you have `@user@domain.tld` work, while
  still serving a different website on `domain.tld`. Takahē will serve requests
  from a subdomain like `takahe.domain.tld`.

Please understand that once you have selected one of these options it
**cannot be changed** without you losing all your follows. Unless you are very
sure what you are doing, **we suggest using a Takahē-specific subdomain**.

You will be able to log into Takahē using the same credentials either at
[takahe.social](https://takahe.social) or under your custom domain; it will
work the same either way.


## Whole Domain

To point a whole domain at us, you need to add a DNS CNAME from that domain
to `takahe.social`.

If you are trying to point an apex domain that does not
support CNAMEs, you can make an A record that points to our IP address
of `104.198.180.195`. This IP may change as we get our network setup fully
stabilised; we will try and let you know via email when this is going to
happen.

Note that no subdomains of the domain you provide will work, not even `www`,
as we will only issue an SSL certificate for the exact one you provide.


## Takahē-Specific Subdomain

To point a subdomain at us, you will need to add a DNS CNAME for it to
`takahe.social`.

If you then want account handles to work off of your main domain, you will
need to proxy through these URLs from that main domain to the subdomain:

* `/.well-known/webfinger`
* `/.well-known/host-meta`
* `/.well-known/nodeinfo`