https://github.com/minchinweb/docker-ddns

Dynamic DNS updater for Domain-DNS.com, in Docker
https://github.com/minchinweb/docker-ddns

docker-image dynamic-dns

Last synced: 25 days ago
JSON representation

Dynamic DNS updater for Domain-DNS.com, in Docker

• Host: GitHub
• URL: https://github.com/minchinweb/docker-ddns
• Owner: MinchinWeb
• Created: 2019-04-22T16:23:32.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2024-06-13T05:33:58.000Z (5 months ago)
• Last Synced: 2024-06-13T16:51:49.865Z (5 months ago)
• Topics: docker-image, dynamic-dns
• Language: Python
• Size: 43 KB
• Stars: 0
• Watchers: 3
• Forks: 0
• Open Issues: 5
• Metadata Files:
  • Readme: Readme.md

Awesome Lists containing this project

README

        
# Dynamic DNS

Update DDNS at [Domain-DNS.com](https://domain-dns.com/)

[![GitHub issues](https://img.shields.io/github/issues-raw/minchinweb/docker-ddns.svg?style=popout)](https://github.com/MinchinWeb/docker-ddns/issues)

## How to Use This

This is only useful if you have your DNS at

[Domain-DNS.com](https://domain-dns.com/), which is only an option if you use

[BareMetal.com](http://baremetal.com/) as your domain register.

For the URL you want to update, there will be a "Remote IP Key" listed.

Then, supply the needed environmental variables in your `docker-compose.yaml`

file:

      ddns:

        image: ghcr.io/minchinweb/ddns:1

        restart: unless-stopped

        environment:

          - PUID=${PUID}

          - PGID=${PGID}

          - DDNS_DOMAIN_NAME=<

          - DDNS_KEY=<>

        volumes:

          - /etc/localtime:/etc/localtime:ro

Adding `localtime` as a volume will make the timestamps on your log files match

your host timezone.

Then, on start up and about every 5 minutes afterwards, the IP address of your

server will be checked. If it's the same as it was before, nothing happens; if

it's changes, an update request is submitted.

## Why I Created This

or, *What Problems is This Trying to Solve?*

I have a dynamic IP address and a URL for my Docker server. Automation seems

like the smart way to keep the URL pointing to that IP address, even if that IP

address changes.

## Prior Art

This is based on my [Python base

image](https://github.com/MinchinWeb/docker-python).

## Known Issues

- Domain-dns sets their TTL ("Time To Live") to 20 minutes (and there doesn't

  seem to be a way to manually override that), so updates may take up to 40

  minutes to show on end-users' machines.

- If you still can't connect to your server after this is working, you may need

  to configure port forwarding on your router. Also, your ISP may be blocking

  the port you are trying to connect on.

- I have no idea if this will work with any other DDNS service. Pull requests

  are welcomed though.