Skip to main content
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

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.
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

After adding your config file, commit the change:
git add .
git commit -m "Add yourname.owns.it.com"
git push origin main
Then go to your fork on GitHub and open a pull request to the original repo.
Once reviewed and approved by a maintainer, your PR will be merged.Within a few minutes, your subdomain will go live and be accessible via the DNS configuration you provided.

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?


Ready to get started?
Fork the repository now →