README.md

Domeneshop.no DNS boot

Bot for users of domeneshop.no. Keep your dns records updated with public ip for your self hosted sites and services.

Only IP will be updated by the bot; record type, ttl and hostname will remain the same

• Built upon domeneshop.no's own python API.
• Using https://api.ipify.org to get the public IP

Installation

pip3 install domeneshop-bots

Usage

See the documentation at https://api.domeneshop.no/docs/ for help on how to acquire your API credentials.

1. Fill inn API credentials and domains to track

{
  "api": {
    "token": "<your-domeneshop.no-token>",
    "secret": "<your-domeneshop.no-secret>"
  },
  "track": [
    {
      "domain": "yourdomainA.com",
      "hosts": ["subdomainA", "subdomainB", "subdomainC"]
    },
    { "domain": "yourdomainB.com", "hosts": ["@", "www"] },
    { "domain": "yourdomainC.com", "hosts": ["@", "www", "subdomain"] }
  ]
}

Hostname defaults

• "@" -> https://domain.com : domeneshop.no uses '@' to indicate root domain

• "www" -> https://www.domain.com : in case you have added a 'www' dns to root domain as well

• "subdomain" -> https://subdomain.domain.com : only subdomain should be specified

2. Fire the bot up, example loading json from file

import json
from domeneshop_bots import DNSBot


if __name__ == "__main__":
    with open("./config.json", 'r') as file:
        config = json.loads(file.read())
        bot = DNSBot(config)
        bot.start()

3. Set up a cron job, and you are done!

Or not. In any case you know what to do!

Docker container

You can also use this service as a container.

See docker-compose.yml for example

Authors

• Erik Larsen - Grizzlyfrog

License

This project is licensed under the MIT License - see the LICENSE file for details

Acknowledgments

Thanks to domeneshop.no for creating an API!!