domain-forward/README.md

# Domain Forward

The [service](https://hosterra.eu/projects/public/forwarder.php) to forward domains using HTTP(s) redirects via Hosterra DoH.


#### Example scenarios:

+ Forward non-www to www domains or vice versa
+ Forward old domains to new domains
+ Forward "parked" domains to a bid platform
+ Forward you own domain to your LinkedIn page
+ …

#### How does it works?

+ Point your domain to Hosterra using CNAME or A/AAAA records
+ Tell us where to forward using TXT records
+ We handle redirection and HTTPS certificates for you

## Get Started

To forward from `www.old.com` to `old.com`, add these records to your DNS:

```
www.old.com.            IN    CNAME   fwd.hosterra.tech
_forward.www.old.com.   IN    TXT     forward-to=https://old.com/*
```

Because CNAME can't be used in apex domains, you can use A/AAAA records.
To forward from `old.com` to `new.net`, add these records to your DNS:

```
old.com.            IN    A       51.159.188.120
old.com.            IN    AAAA    2001:bc8:1210:656:dc00:ff:fe26:bfdd
_forward.old.com.   IN    TXT     forward-to=https://new.net/*
```

The star `*` at the end tells us that the remaining URL path is also forwarded to the destination URL. If you want to forward to a unique url, just omit this star.

> If you use Cloudflare or any DNS which supports [CNAME Flattening](https://blog.cloudflare.com/introducing-cname-flattening-rfc-compliant-cnames-at-a-domains-root/), you still can use CNAME records pointing to `fwd.hosterra.tech`. It is recommended to use CNAME records rather than A/AAAA records.

You can choose the type of redirection you want to use by declaring the `http-status` value:

```
www.old.com.            IN    CNAME   fwd.hosterra.tech
_forward.www.old.com.   IN    TXT     http-status=302;forward-to=https://new.com/*
```

> HTTP status codes 301, 302, 303, 307 and 308 are supported. By default it's 301, which is permanent redirection.

## Credits

This software is based on the invaluable work from [Wildan M](https://github.com/willnode/forward-domain) and [BYU Internet Measurement and Anti-Abuse Lab](https://github.com/byu-imaal/dohjs). Endless thanks to them and all the contributors to these two projects.