Quickstart

Follow these simple steps to claim your free subdomain under owns.it.com.
No dashboards, no forms — just fork, configure, and submit a pull request.

1. Set up your environment

Clone the repository

Start by forking our GitHub repository.
This creates your own copy where you’ll add your subdomain config.

Once forked, clone it locally:

git clone https://github.com/your-username/register.git
cd register

If you prefer, you can also edit directly on GitHub via the web UI.

Create your subdomain config

Inside the domains/ folder, create a new JSON file named after the subdomain you want. For example:

domains/yourname.owns.it.com.json

Example config:

{
"description": "Project Description",
"domain": "is-not-a.dev",
"subdomain": "example",

"owner": {
    "repo": "https://github.com/username/repo",
    "email": "[email protected]"
},

"record": {
    "A": ["1.1.1.1", "1.0.0.1"],
    "AAAA": ["::1", "::2"],
    "CNAME": "example.com",
    "MX": ["mx1.example.com", "mx2.example.com"],
    "TXT": ["example_verification=1234567890"],
    "CAA": [
        { "flags": 0, "tag": "issue", "value": "letsencrypt.org" },
        { "flags": 0, "tag": "issuewild", "value": "sectigo.com" }
    ],
    "SRV": [
        { "priority": 10, "weight": 60, "port": 5060, "target": "sipserver.example.com" },
        { "priority": 20, "weight": 10, "port": 5061, "target": "sipbackup.example.com" }
    ]
},

"proxied": false
}

You can also use A or TXT records depending on your needs.
See the Configuration guide for all supported formats.

2. Submit your request

Open a pull request

Wait for approval

3. You’re live

Once merged, your subdomain will be active and pointing to your configured service (GitHub Pages, Vercel, etc.).
You can update or remove it at any time by submitting another pull request.

Need help?

Check the FAQ
Review Configuration options
Or open an issue on GitHub

Ready to get started?
Fork the repository now →

Overview

Guides

Common Providers

Help

Community

Legal

1. Set up your environment

2. Submit your request

3. You’re live

Need help?

Overview

Guides

Common Providers

Help

Community

Legal

​1. Set up your environment

​2. Submit your request

​3. You’re live

​Need help?

1. Set up your environment

2. Submit your request

3. You’re live

Need help?