https://github.com/recaptime-dev/rtappdotio-custom-domains

Repo for handling custom domain requests for rtapp.io
https://github.com/recaptime-dev/rtappdotio-custom-domains

Last synced: 2 months ago
JSON representation

Repo for handling custom domain requests for rtapp.io

• Host: GitHub
• URL: https://github.com/recaptime-dev/rtappdotio-custom-domains
• Owner: recaptime-dev
• License: mit
• Created: 2021-05-24T14:47:07.000Z (almost 5 years ago)
• Default Branch: main
• Last Pushed: 2021-06-07T11:22:06.000Z (almost 5 years ago)
• Last Synced: 2023-09-21T13:38:42.019Z (over 2 years ago)
• Size: 4.88 KB
• Stars: 1
• Watchers: 2
• Forks: 0
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# Request for Custom Domain Support

Since our Kutt instance is hosted on [Railway](https://railway.app), we need an way for our users in our instance to make their custom

domains work like magic without facing the `404 Not Found` issue.

## Prerequisite

* You should added your custom domain into your account, preferrbly on an subdomain.

* Your custom domain should point into either one of our instances, depending on where you saved it:

  * `rtapp.tk` - for production instance, which we recommend to point to

  * `dev.rtapp.tk` - for dev instance, where deployments from the `develop` branch happens. (not recommended for normal usage)

* When pointing your DNS records for your custom domain to our Kutt instance, it should be either an `CNAME` or `ANAME` (or `ALIAS`, this might depends on your DNS provider) record. For Cloudflare users, you should orange-cloud the apex domain record to automatically flatten CNAMEs.

  * Otherwise, you should switch to an DNS provider that either supports `ANAME`/`ALIAS` records or CNAME flattening. If you want to let us manage your DNS records in Cloudflare (wbich provided free of charge), [create one here](https://rtapp.tk/cl) (skip if you have one) and add `custom-domains-support@rtapp.tk` as an admin. (You can also request one to be managed by us, but you need to export your DNS records first.)

### Managing DNS records on us

If you want Cloudflare's CNAME flattening, our nameservers are:

* `reserved.ns.cloudflare.com`

* `reserved.ns.cloudflare.com`

_These nameservers may update, [you should subscribe to this issue](https://github.com/RecapTime/rtappdotio-custom-domains/issues/1) for updates._

While managing DNS on us is free of charge, we might nicely ask to [support us](https://donate.madebythepins.tk) to keep this service up and to afford the Pro plan for managed DNS customers in the future.

If your custom domain is probably not on apex domain, you can manage your DNS records on us through Netlify. Please let us know about that in your request.

## How to Request

1. [Use this issue template][link] to submit an request. Remember to fill up these required fields:

    * Custom domain

    * Configured homepage

    * Mailhide.io link for your email address (e.g. ) or your public email address on your GitHub profile

    * DNS provider preference (currently Cloudflare and Netlify only)

    * Your digital signature (by signing off at end of the issue description or fill up the form locally and sign with PGP/Keybase) as your acceptance of the [ToS](https://rtapp.tk/terms).

[link]: https://github.com/RecapTime/rtappdotio-custom-domains/issues/new/choose

```markdown

Signed-off-by: Full Name Here 

-----PGP SIGNATURE START----

...

----PGP SIGNATURE END-----

```

2. An team member with access to our shared GitHub account (`ThePinsTeam`) will add that domain into Railway project's custom domains for an specific environment you picked. If the form is not filled so much, we may asked you to add an TXT record for manual ownership verification purposes, similar to this format:

```txt

your.custom.domain TXT rtappdotio-custom-domain.code= rtappdotio-environment.railwayapp= rtapp-custom-domain.ghIssue=https://github.com/RecapTime/rtappdotio-custom-domains/issues/ISSUE-NUMBER-HERE

```

3. Voila! We'll check within few days to confirm it's working through DNS record lookup and 404-not-found checker. Enjoy your new custom domain. (We may do DNS record checks periodically to ensure it's actively using)

4. If you want to self-host our fork of Kutt, here's [our source code](https://rtapp.tk/source). Remember to export your existing shortlinks first! (Stats not included to be availale for data exports, sadly.) Remove your custom domain's CNAME/ANAME and TXT record (or change it) and we'll remove it from the project dashboard.