cloubit/ddns-updater repository overview

⁠Dynamic DNS Updater on Docker Image

Most Internet service providers change the IP addresses of their connections at regular intervals. This means that when the IP address changes, the DNS entry for a domain becomes invalid. Dynamic DNS Updater automatically updates the IP addresses of the DNS entries. Your provider must offer dynamic DNS. The result is that the network can be accessed from anywhere even after an IP change.

⁠

⁠Register your Dynamic DNS host

1. Register your account on your DNS Provider
2. Create a host
3. Copy your personal API Credentials

⁠Configure the .env file

1. Create a file like touch ddns_update.env.
2. Update your credentials in the following file example.

# your API credentials (The Value DDNS_TOKEN is mandatory)
DDNS_USER=dYourUsername
DDNS_TOKEN=YourSecret

# all variable names must begin with 'DDOMAIN', add as many as you want
DDOMAIN1=your.domain.org

# enable/disable IP version
ENABLE_IPV4=true
# ENABLE_IPV6=true

# Remove the hashtag of your preferred API-URL or add your preferred API-URL.
# APIURL_BASE=https://infomaniak.com/nic/update?hostname=
# APIURL_BASE=https://www.duckdns.org/update?domains=
# APIURL_BASE=https://ydns.io/api/v1/update/?host=
# APIURL_BASE=https://update.dyndns.it/nic/update?hostname=
# APIURL_BASE=https://update.dedyn.io/?hostname=

# select the update repeat, default is 900 (15 min) if disabled
UPDATE_DELAY=1800

⁠Configure the compose.yaml

1. Create a file like touch compose.yaml
2. Copy the following filecontent in your compose.yaml

services:
  ddns-updater:
    image: cloubit/ddns-updater
    container_name: ddns-updater
    env_file:
        - ./ddns_update.env
    restart: always
    networks:
        - internal

networks:
  internal:
    name: ddns-updater
    driver: bridge

⁠Start the Dynamic-DNS-Updater

1. If you want to start the Dynamic-DNS-Updater use folowing command: docker compose up
2. Check the Output: Your IP Adress Update changed: dns_updater | Status update: 'your.domain.org', good 111.222.333.444 or: No IP Adress has changed: dns_updater | Status update: 'your.domain.org', nochg 111.222.333.444 All other Messages ar failure. Check the Credentials.

⁠More Information

More information about the DDNS-Updater-Image you can find about GitHub⁠