Free subdomains for personal sites, open-source projects, and more. Here is a list of supported domain names:
| Domain name | Features |
|:-------------------------------------:|:---------------------------------------------------------:|
| ⚡ [`*.localplayer.dev`](https://localplayer.dev/) | ![cf][badge-cf] ![dnssec][badge-dnssec] ![ssl][badge-ssl] |
| ⚡ [`*.is-not-a.dev`](https://is-not-a.dev/) | ![cf][badge-cf] ![dnssec][badge-dnssec] ![ssl][badge-ssl] |
> Wildcards (like `*.foo.is-not-a.dev`) are supported too, but the reason for their registration should be very clear and described in detail.
[badge-cf]:https://shields.io/badge/%20-cloudflare-blue?logo=cloudflare&style=plastic?cacheSeconds=3600
[badge-dnssec]:https://shields.io/badge/%20-DNSSEC-blue?logo=moleculer&logoColor=white&style=plastic?cacheSeconds=3600
[badge-ssl]:https://shields.io/badge/SSL-Required-blue?style=plastic?cacheSeconds=3600
## Why?
First of all, I want to answer one important question - "Why are you giving out domains for free?". Because sometimes I need domains for my pet projects, and instead of buying new domains every time, I decided to buy one for everyone, and use subdomains. And why not share them with the community?
## Domains settings
| Option | `*.localplayer.dev` | `*.is-not-a.dev` |
|:--------------------------------------------------------------------------:|:-------------------------:|:-------------------------:|
| [DNSSEC][dnssec] | ✅ | ✅ |
| Email | ❌ | ❌ |
| SSL/TLS * | [Full][ssl-full] | [Full][ssl-full] |
| Always Use HTTPS * | ✅ | ✅ |
| HTTP Strict Transport Security (HSTS) | ✅ | ✅ |
| Minimum TLS Version * | TLS 1.2 | TLS 1.2 |
| Opportunistic Encryption, TLS 1.3 * | ✅ | ✅ |
| WAF (Web Application Firewall) * | ✅ (Medium Security Level) | ✅ (Medium Security Level) |
| Browser Integrity Check * | ✅ | ✅ |
| [Caching Level][caching-levels], Browser Cache TTL * | Standard, 4 hours | Standard, 4 hours |
| [Crawler Hints][crawler-hints] * | ✅ | ✅ |
| [HTTP/2][http2], [HTTP/2 to Origin][http2-to-origin], HTTP/3 (with QUIC) * | ✅ | ✅ |
| [0-RTT Connection Resumption][0rtt] * | ✅ | ✅ |
| [gRPC][grpc], WebSockets * | ✅ | ✅ |
| [Pseudo IPv4][pseudo-ipv4] * | Add header | Add header |
| IP Geolocation (HTTP header `CF-IPCountry`) * | ✅ | ✅ |
| Maximum Upload Size * | 100 MB | 100 MB |
> `*` Available only when proxying (`"proxy": true`) is enabled
[dnssec]:https://developers.cloudflare.com/dns/additional-options/dnssec
[ssl-full]:https://developers.cloudflare.com/ssl/origin-configuration/ssl-modes/full/
[ssl-flex]:https://developers.cloudflare.com/ssl/origin-configuration/ssl-modes/flexible/
[caching-levels]:https://developers.cloudflare.com/cache/how-to/set-caching-levels
[crawler-hints]:https://blog.cloudflare.com/crawler-hints-how-cloudflare-is-reducing-the-environmental-impact-of-web-searches/
[http2]:https://www.cloudflare.com/website-optimization/http2/what-is-http2/
[http2-to-origin]:https://developers.cloudflare.com/cache/how-to/enable-http2-to-origin
[0rtt]:https://developers.cloudflare.com/fundamentals/network/0-rtt-connection-resumption/
[grpc]:https://support.cloudflare.com/hc/en-us/articles/360050483011
[pseudo-ipv4]:https://support.cloudflare.com/hc/en-us/articles/229666767
# How to get one?
1. Star and [fork](https://github.com/open-domains/Register/fork) this repository (follow [this guide](https://github.com/firstcontributions/first-contributions) if you don't know how to make a contributions)
2. Add a new file called `..json` in the `./domains` folder to register `` subdomain
3. Edit it (below is just an **example**, provide a **valid** JSON file with your needs, the format is very strict; format you can [check here](https://jsonlint.com/)):
```json
{
"$schema": "../schemas/domain.schema.json",
"description": "",
"domain": "",
"subdomain": "",
"owner": {
"repo": "",
"email": ""
},
"record": {
"CNAME": "",
"TXT": ["list", "of", "required", "txt", "records"],
"A": ["list", "of", "IPv4", "addresses", "like", "a", "127.0.0.1"],
"AAAA": ["list", "of", "IPv6", "addresses", "like", "a", "::1"],
"NS": ["list", "of", "nameservers"]
},
"proxy": false // disable the CF proxy, proxying is always enabled by default
}
```
4. Your pull request will be reviewed and merged. Please, don't ignore the PR checklist. If you ignore this repository rules, your PR will be ignored too. _Make sure to keep an eye on it in case we need you to make any changes!_
5. After the pull request is merged, please allow up to 24 hours for the changes to propagate _(usually, it takes 5..15 minutes)_
6. Enjoy your new domain!
> Domains, used for illegal purposes will be removed and permanently banned. Please, provide a clear description of your resource in the PR.
## If you don't know...
- What is GitHub pages and how to set up a custom domain, read the [docs here](https://docs.github.com/en/pages/configuring-a-custom-domain-for-your-github-pages-site)
- The difference between `A`, `CNAME`, and other record types, the article on Wikipedia [is here](https://en.wikipedia.org/wiki/List_of_DNS_record_types)
> 🔍 A few similar services can be [found here](https://free-for.dev/#/?id=domain).
[badge-tests]:https://img.shields.io/github/workflow/status/open-domains/Register/tests?label=tests&logo=github&style=for-the-badge
[badge-deploy]:https://img.shields.io/github/workflow/status/open-domains/Register/deploy?label=deploy&logo=github&style=for-the-badge
[actions]:https://github.com/open-domains/Register/actions
[deploy]:https://github.com/open-domains/Register/actions/workflows/deploy.yml
# This repo was forked from
https://github.com/tarampampam/free-domains