joweisberg / docker-dynamic-dns

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

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)
• USER: the username for the service.
• PASSWORD: the password or token for the service.
• 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.
• 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.
• 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.

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:

Platform	Architecture / Tags
x86_64	amd64
aarch64	arm64
arm	arm32

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 USER="username" -e PASSWORD="password" -e SERVICE="freedns" -e HOSTNAME="sub.example.com" -e DETECTIP=1 -e INTERVAL=10 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
      - USER="username"
      - PASSWORD="password"
      - SERVICE=freedns
      - HOSTNAME="sub.example.com"
      - DETECTIP=1
      - INTERVAL=10
    healthcheck:
      test: /usr/bin/healthcheck
      interval: 10s
      timeout: 5s
      retries: 5