Custom domains

From WikiTide Meta
Other languages:
  • English
Custom domains

WikiTide lets you use a custom domain for your wiki. Instead of having to use mywiki.wikitide.org (a subdomain of wikitide.org), you can use your own domain (e.g., mywiki.com, wiki.domain.com, etc.). Read the steps below for more information.

Steps[edit | edit source]

Setting up a custom domain is as easy as following 4 steps:

1. Get a domain.

  • To set up a custom domain, you will need to get a domain. There are many reputable registrars such as Namecheap where you can purchase a domain. Don't want to pay money for a domain? Click here for free domain services.

2. Point it to WikiTide.

  • Once you have a domain, you'll need to point it to WikiTide. You can either point the nameservers to WikiTide or set a CNAME record for the subdomain you want your wiki on pointing to mw-lb.wikitide.org.
  • Pointing the nameservers to WikiTide? Set the nameservers to "ns1.wikitide.net" and "ns2.wikitide.net" (contact your domain registrar if you don't know how to do this).
  • Pointing a subdomain to WikiTide? Add a CNAME record on the subdomain you want (e.g., "wiki."), and point it to "mw-lb.wikitide.org";
 Note: If you are using Cloudflare as your DNS provider, you'll need to make sure some settings aren't set or the subdomain won't work. Click here to learn more.

What should I choose?

Each option has different pros and cons:

  • If you do choose to point the nameservers to us, we can handle all things related to DNS without needing your intervention. However, if you choose to do this, you'll need to ask us to create new DNS records every time you need to add a new one. If you change your nameservers and have records set already (e.g., you have www. pointing to your website), you'll need to ask us to recreate them or else your subdomains will be unreachable once you change the nameservers. If you don't plan to make frequent changes to the DNS records or are fine with us handling it for you, choose this.
  • If you choose to simply point a subdomain to WikiTide, you'll have complete control of your DNS records, but you'll need to manually set records yourself with your DNS provider.

3. Choose who will provide an SSL certificate.

  • For your safety, WikiTide uses SSL/TLS to encrypt the connections from our servers to your browser to make sure no one intercepts your connection. For this reason, we require all custom domains to have an SSL certificate. You can either provide us your own SSL certificate (you would have to pay for it) or let us handle it completely (for free, via Let's Encrypt). This is the easier and WikiTide-recommended option. If you have no idea what SSL means or is, select the Let's Encrypt option.
  • If you choose to let us handle it: We can generate an SSL certificate (using Let's Encrypt) ourselves and even renew it automatically for the subdomain you chose without needing any additional intervention from your part, your work is done!
  • If you have chosen your own SSL certificate: After you make your custom domain request, a system administrator who handles CSR requests will generate a CSR & private key (for use on our own servers), and the requested CSR will be emailed to you. You use this CSR to request your SSL certificate vendor to generate an SSL certificate with the CSR we gave you. You will need to email us the generated SSL certificate when this is done. If all of these steps are done, we will add the custom domain to your wiki, and we will notify you when this all is done.

4. Make the request!

  • Once you've done the steps above and have chosen who will provide the SSL certificate, make the request on Phorge. In the form, all you need to do is provide your wiki's current subdomain, your desired domain, and whether or not you'll use Let's Encrypt (us handling the SSL) or if you'll provide an SSL certificate yourself.
Custom domain request form (via Phorge)

Need help with any of the steps or have a question? Ask our friendly users on the Community portal for help!

Note for Cloudflare users [edit | edit source]

Cloudflare users must turn off Cloudflare's DDoS/Origin IP protection system/workers. This is not negotiable. With it enabled, WikiTide cannot process SSL certificate requests, and it creates problems with our internal systems, including security issues. Our IPs are already public, so we do not need Origin IP protection, and we have DDoS protection through our network vendor.

Follow the steps to find out how to disable Cloudflare DDoS/Origin IP protection system (assuming you're using the dash.cloudflare.com dashboard).

  1. Go to dash.cloudflare.com
  2. Click your domain in the dashboard.
  3. Go to "DNS".
  4. Add CNAME entry to cf-lb.wikitide.org. The cloud with an arrow must be gray. If it is yellow, click it to make it gray.
  1. Click "Add Record". The result has to look like the last image.

If you are done with this, continue back on the steps above.

 Note: Not following the rules above will result in your custom domain being removed immediately and further action being taken if necessary. In case of any doubt, feel free to contact us at sre(at)wikiforge.net or ask on the Phorge task you create.

Cloudflare dashboard
Cloudflare dashboard
Domain section.
Domain section
Your entry should look like this!
Your entry should look like this!

FAQ[edit | edit source]

What services can I use to get a free domain?[edit | edit source]

If you don't wish to pay for a domain of your own, there are services that offer free domains and subdomains that you can use instead. Remember that all WikiTide wikis automatically get a free subdomain on wikitide.com.

Free (sub)domain providers

FreeeDNS example[edit | edit source]

Sign up with FreeDNS and log in. On the left side, click 'Registry' to select a domain (e.g., mine.bz). This will take you to a small form to fill in. Please avoid using a us.to domain, as it is impossible to generate a Let's Encrypt certificate for these. Add a subdomain (keep trying until you find an available one, e.g., mario). Select 'CNAME' for the type. In the destination field, enter mw-lb.wikitide.org, solve the captcha, and click the save button.

FreeDNS example setup
FreeDNS example setup.

Then follow the above step 4. Make the request!.

Can I change the URL structure?[edit | edit source]

WikiTide is not configured to serve pages from the domain root. For example, if your wiki is example.wikitide.com and its main page is called "Welcome", then the URL will not be https://example.wikitide.com/Welcome but instead https://example.wikitide.com/wiki/Welcome (note the /wiki/ piece). Likewise, even if you use a custom domain, WikiTide will still serve pages with this URL structure. When users visit pages on the root (e.g., without the /wiki/), they'll be greeted by a page asking them if they meant to go to a page on the /wiki/ subdirectory and will provide them a link.

 Note: WikiForge wikis can have the /wiki/ removed from their URL structure.

What SSL certificate authorities do you accept?[edit | edit source]

WikiTide accepts most SSL certificate authority that are accepted by browsers such as Mozilla Firefox. However, we do not accept WoSign certs anymore.

Current authority used by WikiTide custom domains[edit | edit source]

Below is a list of the current SSL certificate authority used by custom domains. This does not mean that others not in this list are not accepted.

  • Let's Encrypt - managed by WikiTide, all steps regarding Let's Encrypt (except setting nameservers) are done by WikiTide system administrators
  • Comodo
  • Gandi
  • GeoTrust
  • GlobalSign
  • GoDaddy
  • RapidSSL