joweisberg/dynamic-dns repository overview

⁠docker-dynamic-dns

This is a fork of blaize/docker-dynamic-dns⁠ to extend for FreeDNS.afraid.org (freedns) and OVH service

This project:

• GitHub joweisberg/docker-dynamic-dns⁠
• Docker Hub joweisberg/dynamic-dns⁠

⁠Docker Dynamic DNS to use Google Domains, DuckDNS, DynDNS, FreeDNS.afraid, NO-IP and OVH

Dynamic DNS services have been around since the early days of the internet. Generally speaking, internet service providers (ISP's) will reassign an IP address to a subscriber after some period of time or if the user reconnects his or her connection.

The environmental variables are as follows:

• TZ: name of the TimeZone - ie. "Etc/UTC" or "Europe/Paris" (https://en.wikipedia.org/wiki/List_of_tz_database_time_zones⁠)
• SERVICE: The service you are using. Currently, the script is setup to use Google Domains (google), DuckDNS (duckdns), DynDNS (dyndns), FreeDNS.afraid.org (freedns), NO-IP (noip) and OVH DynHosts (ovh). Set the service to the value in parenthesis.
• USER: the username for the service.
• PASSWORD: the password or token for the service.
• HOSTNAME: The host name that you are updating. ie. example.com
• DETECTIP: If this is set to 1, then the script will detect the external IP of the service on which the container is running, such as the external IP of your DSL or cable modem.
• IP: if DETECTIP is not set, you can specify an IP address. Default value is 1.
• UPDATEIPV6: If this is set to 1, then the script will detect the external IPv6 address of the service on which the container is running.
• INTERVAL: How often the script should call the update services in minutes. Default value is 10 minutes.

⁠Installation via Docker

Please follow the official documentation:

https://docs.docker.com/install/

⁠Docker image platform / architecture

The Docker image to use joweisberg/dynamic-dns:latest. Build on Linux Ubuntu 20.04 LTS, Docker 19.03 and above for:

⁠Docker

⁠Get the container

$ docker pull joweisberg/dynamic-dns:latest

⁠Run the container in console mode (notice the environment variable setting parameters for the startup command)

$ docker run -d --restart="unless-stopped" -e TZ="Europe/Paris" -e SERVICE="freedns" -e USER="username" -e PASSWORD="password" -e HOSTNAME="sub.example.com" joweisberg/dynamic-dns:latest

⁠Run the container via docker-compose

version: '3.5'
services:
  dynamic-dns:
    container_name: dynamic-dns
    image: joweisberg/dynamic-dns:latest
    restart: unless-stopped
    environment:
      - TZ=Europe/Paris
      - SERVICE=freedns
      - USER="username"
      - PASSWORD="password"
      - HOSTNAME="sub.example.com"
    healthcheck:
      test: /usr/bin/healthcheck
      interval: 10s
      timeout: 5s
      retries: 5