ionos-dynamic-dns/README.md

Ionos DNS updates

A set of scripts used to make dynamic DNS updates to the Ionos API.

Dependencies

Python libraries:

• requests
• pyyaml

Initial setup

Install the dependencies, preferrably using your system's package manager.

Next, you will need your Ionos API keypair. Clone the repo and edit the file apikey.yml. Inside the file, paste the respective value of your Ionos API-keypair, following this format:

---

apikey:
  prefix: <your api key prefix>
  secret: <your api key secret>

...

This file must be kept secret.

Adding target domains

Add every domain you want to send an update for to the file domains.json. The file should list each domain whose global DNS record should point to the local host's public IP. The file must have the following format:

{
  "domains": [
    "example.com",
    "subdomain1.example.com",
    "subdomain2.example.com",
  ],
  "description": "My dynamic DNS."
}

The description can have any string as a value, but it must be present.